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FOREWORD 


This Users Manual was written to acquaint the Users 
of the Stanford Computation Center with the facilities 
and services offered by the Campus Facility. 


In particular, this Second Edition describes the 
facilities available and the methods for using the 
IBM 360/67. 


Users can expect revisions to this manual as new 
systems and methods for the 360/67 develop. Changes 
may also be made to the present material in order to 
rectify omissions and to clear up possible ambiguities 
of which we may or may not be aware, In this regard, 
the Users Services Group, Campus Facility, would 
welcome constructive contributions from Users for 


future issues, 


Eileen Jensen, 
Editor 


ii 


May 1968 
To Our Users... 


The enclosed material updates the Second Edition of the Campus Facility 
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1, INTRODUCTION 


1.1 The Stanford Computation Center 


1.1.1 History 
The Stanford Computation Center was formed in March 1954, with the 


installation of an IBM Card Programmed Calculator in the basement of 
Encina Hall. As computing grew at Stanford, so did the role ofthe 
Computation Center, until it came to encompass the major computing 
activities at Stanford. In order to service this growing and sophis- 
ticated user community, the Computation Center reorganized as a set of 
several facilities. The computers located in Pine Hall became the 
Campus Facility. As work on the Stanford Linear Accelerator Center 
neared completion, the SLAC Facility was formed to provide the special 
computation requirements associated with it. ACME (A Computer for 
MEdical Research) is a research project sponsored by the National In- 
situtes of Health for the purpose of furthering medical research with 
an on-line computer system tailor-made for data acquisition and the 
control of experiments. The Real Time Facility was created to handle 


the needs of this project. 


1.1.2 Organization 


While each of the facilities is a physically separate center, the 

responsibility for coordination, control, and operation is vested in 
the Computation Center as a whole. In this way, Stanford's computer 
expertise is consolidated to the benefit of everyone. The following 
chart indicates the organization of the Computation Center and lists 
the key personnel for each group. A personnel directory is also in- 
cluded and provides a handy list of telephone numbers which are rele- 


vant to the users of the various facilities. 
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COMPUTATION CENTER PERSONNEL DIRECTORY 


NAME TITLE/ FUNCTION LOCATION EXTENSION 
Stanford Computation Center 

E. Feigenbaum Director Polya 115 4879 

N. Nielsen Deputy Director Polya 119 4885 

G. Mickelson Secretary, Director's Office Polya 117 770 


Campus Facility 


R. Fredrickson Associate Director Polya 109 2897 
M. Lieberman Assistant Director Polya 107 493 
A, Broell Secretary Polya 105 2897 
R. Montgomery Operations Manager Pine 186 4873 
P, Gilman User Services Manager Polya 156 4hoo 
E. Jensen Systems Documentation Pine 185 4877 


SLAC Facility 


C. Dickens Associate Director SLAC 8545 
D. Millard Secretary SLAC 8545 
R. Ivan Special Assistant SLAC 8655 
M. Ray Operations Manager SLAC 8545 


Real Time Facility 


G. Wiederhold Associate Director $009 5818 
G. Plasch Secretary . $009 5818 
C. Class Operations Manager 5903 
K. Holtz Engineer SOO7D 5820 


Inter Facility 
R. Jamtgaard Associate Director Polya 112 43104 
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1.2 The Facilities 


1.2.1 Real Time Facility 
Function and Equipment: The Real Time Facility provides specialized 


real time capabilities for medical researchers. To this end the ACME/PL 
programming language and the ACME time-sharing system were specially 
constructed to provide real-time data collection capability. This sys- 
tem is now running on an IBM 360/50 - 1800 system located at the Stanford 
Medical School. This system and the planned SDS Sigma 5 in the Facility's 
Hybrid Computer Laboratory will also be available to non-medical research- 
ers who have real time requirements. A diagram of the hardware configura- 


tion (Figure 1.1) is at the end of this section. 


1.2.2 SLAC Facility 
Function and Equipment: The SLAC Facility was created for the sole 


purpose of providing computational support for the accelerator. A 
360/75 with a half-million byte memory is currently installed, and a 
360/91 is scheduled to replace it in 1968. A diagram of the hardware 


configuration (Figure 1.2) is at the end of this section. 


1.2.3 Campus Facility 


Function and Equipment: The Campus Facility provides service for the 
computing needs of the Stanford Community. To this end it provides 
standard batch processing service on its 360/67 and text editing and 
remote job entry from terminals is available. A diagram of the hard- 
ware configuration (Figure 1.3) is at the end of this section. 
Descriptions of the system's software capabilities may be found in 


Sections 3, 4 and 6 of this manual. 
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1.3 Inter-facilities 


The centralized organization of the various facilities allows the 
Computation Center to offer a number of common services. In this way 
users of all facilities are able. to share the benefits arising from 


such cooperation, A few of these inter-facility services are: 


Program Library: programs incorporated in the program library by 
one facility can often be included in the libraries of other 
facilities. Thus a much larger library of programs can be certi- 


fied and offered to the user. 


Systems Documentation Office: this office maintains a record of all 


printed information available on the systems and program library 
used at Stanford. It also provides a central source for procuring 


system manuals, program documentation, SHARE programs, etc. 


Operations: the operational requirements of the facilities are 
coordinated so that operators or machine time can be provided one 
facility by another in the case of protracted hardware difficul- 
ties. In this wey more consistent service can be provided to all 


of our users. 


Systems expertise: a close liaison is maintained between the 
systems personnel at the various facilities. Thus a bug discovered 
and corrected at one facility can be immediately corrected at the 
other facilities without each group having to "re-invent the wheel, " 
Again, this enables us to provide better computational service to 


our users. 


Computer Science Library: this library in Polya Hall is also avail- 


able as a resource for the Computation Center. It contains hundreds 
of volumes on programming, numerical analysis, and nonnumeric compu- 
tations. Also available is a set of the major periodicals in the 
computer field. 
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1.4 User Eligibility 

The services of the Campus Facility are available to all faculty, staff, 
and students of the University and to University-related personnel off- 
campus for use in connection with research and instructional activities. 
Special arrangements for non-university work may be made with the Asso- 
ciate Director, Campus Facility, Room 105, Polya Hall, Ext. 2897. 


Use of the other facilities is also restricted by these same conditions. 
However, since the other facilities are not general purpose facilities, 
there are additional restrictions on their use. The STAC Facility is 
open only to SLAC personnel working on projects connected with the re- 
search work being performed at the linear accelerator. Likewise, the 
Real Time Facility is restricted to Stanford Medical School researchers 


and projects requiring real-time data collection. 


Users who are uncertain about their eligibility to use a particular 
facility should contact the Director of the Computation Center or the 


Associate Director of the facility in question. 
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Figure 1.1 Real Time Facility Machine Configuration 
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NOTE: 
THE MODEL 91K CPU WILL 
BE INSTALLED IN OCTOBER 
1968. A MODEL 751 CPU HAS 
BEEN LEASED IN THE INTERIM. 
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Figure 1.2 SLAC Facility Machine Configuration 
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Figure 1.3 Campus Facility Machine Configuration 
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2. SERVICES AND OPERATIONS 
aE LUN 


2.1 Administrative 


2.1.1 


Account Numbers and Eligibility 


The facilities and services of the Stanford Computation Center, Campus 


Facility, are available for use in connection with research and computer-~ 


related classwork to the faculty, staff, and students of the University; 


to University-related personnel off-campus; and to non-University users 


by special arrangement. 


° 


Computer time is granted on the basis of a formal request made 

on the standard application form and submitted to the Accounting 
Office in Polya Hall. (The application form and supplemental 
application form are illustrated in Figure 2.1 and Figure 2.2.) 
Approval of this form entitles the applicant to the use of all 
services; i.e., the computer, keypunches, and tabulating machines, 


as well as supplies needed, such as paper and cards. 


All work done on the computer requires the approval of the 


authorized faculty member or administrator. 


Costs of the computer use are recharged at current schedules. 
(See Rates, Section 2.1.2.) 


Instructional Use: Total time of computer usage in courses will 
be charged against department budgets at the current rates. De- 
partments should contact the office of the Associate Provost for 
Computing for assistance in procuring funds to supplement depart- 


ment budgets for this purpose. 


Billing: At the end of each calendar month the User receives a 
monthly statement showing how much computer time was charged to 
his account during the billing period. The billing cut-off date 
is the 20th of each month. 


Closing of an Account: At the conclusion of a project, the User 
should notify the Campus Facility Accounting Office in writin 


that the project has ended. 
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APPLICATION FOR SERVICES 
No carbon required 


Please print STANFORD COMPUTATION CENTER 
Leave shaded areas blank CAMPUS FACILITY 


321-2300, EXTENSION 4400 


CHECK 360/67 TIME & AUX. SERV. 360/50 time &@ Aux, senv. B5500 rime & AUX, SERV. 
a ae | Ee ee 
wate, [ee ea Sa ae ee Cd 


NAME OF USER tas aT 
OR PRIMARY CONTACT 
wISCC [t.6., procaammen} 


AUK, SERY, ONLY 


USER'S 
ATHUATION CODE 
(SEE * BELOW): 
STANFORD AFFILIATIONS (IF MORE THAN ONE CODE APPLIES, ENTER THE FIRST APPLICABLE CODE): 


A. ACADEMIC/RESEARCH DEPT. HEAD/ASSOC. HEAD D. PRINCIPAL INVESTIGATOR G. GRADUATE STUDENT 
B. ADMINISTRATIVE DEPT. HEAD/ASSOC. HEAD &, STAFF H. UNDERGRAD. STUDENT 
Cc. FACULTY F. RESEARCH/TEACHING ASST. \. OTHER: 


CODES | NOT AFFILIATED WITH STANFORD {LIST COMPANY, ADDRESS & AFFILIATION): 


MAILING: ADDRESS 

FOR SCC_INFORMATION 
(00 NOT WRITE 

ON THIS LINE} 


SAME AS. | 
*OEPT.*’ ABOVE OTHER: 


SEND BILL TO ence OFAN MR, OTHER 
{Phone X 4795 if auestion ‘Spricame — MIS: 
‘about whom 10 bill} > 0 SY" 71 omer, Tithe: Miss 


BU 1.0, bert. faponass ine an “ 
(sue * asove) 


ON INS LINE] 
C) sultetin Cl ss. 2 other: 


Cw: USER SHOWN (tast name) cras DEAN MMR. OTHER: 
rinst PROF. ree 


SEND ADVISORY INFO TO 
as Os Sana ot ‘ween TT) rue, oa 


BO moe tin Whee 

0 um. C) Bulletin Ci-ss. C) other: 
COMPU ES 
WILL BE USED Na . " 
(2) prosect report []_ Master's THESIS C1 poctor's THesis C1 over 


FUNOS TO BE CHARGED {CHECK ONE. ALSO SHOW UNIVERSITY ACCOUNT NUMBER OR BILLING REFERENCE}: 


[[] School or department funds. 2... » . Univ. Account No 


Cc] Sponsored research funds {contract/grant) . . . Univ. Account No. 


oO Funds without Univ. accountnumber. . . .  . Billing Reference SEES 


[[] Funds approved by Assoc. Provost for Research. . Univ. Account No. 


[_] Computation Center. 2 ©... e« Univ. Account No. 


FUNDS BUDGETED FOR THIS APPLICATION. 6 we ee te. 


Used by Computation Center to project rates and estimate use. The monthly statement will indicate charges ot close of si | 
period, The Computation Center cannot limit charges—this is your sole responsibility. 


LIMIT IN HOURS: System facilities ore provided on the B5500 which allow you some controt over the expenditure of funds, Remember, however, that other charges can 
be incurred, such as plotter time, disk storage, dato cells, etc. If you wish such a limit established please indicate. 


UMIT: ours 


SIGNATURES: To protect the University's obligation under the manufacturers’ educational allowance programs and non-profit tax- free position, the use of computers must be 
restricted to educational activity unless special arrangements are made with the Computation ‘Center Associate Director, Cariput Facility (Ext. 2897). This is 
defined as instructional or research use which Is non-proprietary, publishable, and performed by the Faculty, Students or Staff. The Computation Center ‘expects 
your cooperation in limiting the use to these activities or advising it of your use which does not meet this restriction. 


a i a Fe x 5 rai 
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o CHECK HERE IF ACCOUNT 1S FOR INSTRUCTIONAL PURPOSES 
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SUPPLEMENTAL APPLICATION FORM 
(To be used with Regular Application) 
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Job Number 
(C.C. use only) 
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2.1.2 Rates 
The following rate schedule reflects the rates that went into effect 
October 21, 1967 and also reflects the effect of the new scheduling 
algorithm that went into operation on February 20, 1968. These rates 
apply to the 360/67 services offered by the Stanford Computation Center, 
Campus Facility. 

Interim 360/67 Rate #3* 


Processor Charge: 
PRIORITY OPTIONS 


Execution i Maximum 


Order Execution Time 


“D210. 10+ 


Wo) 
(minutes) 2 ins. tins. 


exarnana] enaNpARD 


*¥** This is a declining rate dropping 8.50 per minute each successive 
half hour of continuous running. The minimum rate permissible is 
based on the average rate per hour for the run which is floored at 
$300 per hour. 


EXPRESS is the default priority assigned jobs entered from the terminals 
when the estimated job time is 2 minutes or less; otherwise, for jobs en- 
tered from the terminals with an estimated job time > 2 minutes, the pri- 
ority is STANDARD. The default priority assigned Jobs entered from the 
card readers is STANDARD. 


The purpose of the IDLE priority and its low rate is to attract a backlog 
of jobs to be run at times when the machine would otherwise be idle. The 
relatively short 1 minute limit is set to minimize possible impact on 
higher priority jobs. A job submitted which has an execution estimate > 1 
minute is rescheduled by the system to an OVERNITE priority and OVERNITE 
rates are applied. The print priority for an IDLE execution job is IDLE. 
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Output Lines: 


Service Print 
Order Priority 
URGENT $5.00 + $1.00/thousand lines 
PRIORITY $1.00/thousand lines 
< 2k lines 
< 5k lines 
STANDARD 4 < 15k lines? $0.50/thousand lines 
> 15k lines 
IDLE $0.50/thousand lines 
OVERNITE $0.50/thousand lines 
NOPRINT sade 


1 
2 
h 
> 
6 
if 
8 
9 


(See the notes at the end of the rate schedule on how to use priority. ) 
Other Rates: 


2741 Terminal Access Duration $4/terminal/hour 
Charge and CPU Editing (WYLBUR) 


2741 Terminal and Line Rental:** 


Business Telephone Line Connection $125.47/month (as of July 1, 1968, 
$138.91/month) + $135 initial 


installation. 
Private Line Concentrator Distri- $118.42/month (as of July 1, 1968, 
butor System $131. 86/month) + $130 initial 
. installation. . 
Disk Storage (2314) 1¢/track (~7,188 bytes )/day. 
(reserved file, not scratch use) 
Tape Storage $2/tape/ month. 
Input Cards 25¢/thousand cards. 
Output Cards $1 + $4/first thousand cards, 
$1.25/additional thousand/run. 
Plotting $25/hour for Off-line Plotting and 
$1 + 10¢/minute for On-line Plot- 
ting (when available). 
Forms Change $5/ change. 
Printer Adjustment Service $5/ adjustment. 
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Key Punching $4. 25/hour. 


Special Services $4. 25/hour. 
(As described in Section 2.3.4) 


*NOTE: 


**NOTE: 


NOTE 1: 


The 2741 terminal rates are new. Other changes from Interim 
Rate #2 include overnight CPU time at $7. 00/minute, a reduc- 
tion to 1¢/track/day for 2314 disk storage, and a reduction 

for output cards beyond the first 1,000 cards on any one run. 


Terminal, line rental, and installation costs cannot be charged 
to Provost's Funds for computer usage. 


How to use priority from the terminal. 


Priority control over both execution and printing may be exer- 
cised when issuing the RUN, LIST OFFLINE, and PUNCH commands. 
If no explicit priority is made, the execution priority is 
assumed to be EXPRESS and the print priority is assumed to be 
STANDARD (the service order depends on the number of lines). 


EXPRESS .runs having an estimated execution time in excess of 
two (2) minutes are rescheduled by the system to STANDARD. 


If only one priority option is indicated, it is assumed for 


both execution and printing. 


USAGE: RUN <execution option>,<print option> <other options> 
LIST OFFLINE <execution option>,<print option> <other 
options> 
PUNCH <execution option>,<print option> <other options> 
EXAMPLE: COMMAND ? run idle bin 555 
COMMAND ? run p,s b 666 


NOTE 2: How to use priority from the card readers. 


Priority control over both execution and printing may be exer- 
cised when entering jobs from the card readers. If no explicit 
priority is made (by the /*RUN card before the job card) the 
job will be scheduled for execution and printing under STANDARD 


priority. 


There is no EXPRESS priority available to a job entered from the 


card readers. 
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If only one priority option is indicated, it is assumed for both 


execution and printing. 
USAGE; /*RUN <execution option>,<print option> 


Options must be specified starting in column 16, separated by a 


comma, and with no interspersed blanks. A short form consisting 
of just the first character may be used in place of the full 


word. 
EXAMPLE: /*RUN PRIORITY , STANDARD 
/ *RUN P,s 
Remember: for a completely Standard run no {*RUN card is 
required. 
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2.1.3 360/67 Refund Policy and Procedure 


The Computation Center, Campus Facility, may refund the time charged 
to a User's account for a 360/67 run which failed due to circumstances 
beyond the User's control. It is our opinion that the responsibility 
for obtaining the information necessary for using the computing facil- 
ities lies with the User. In considering refund requests, we take the 
position that the programmer is responsible for writing his program 
and preparing his control cards in a manner that provides complete © 
protection for his job. Users who believe they have incurred an unfair 
charge should ask the Consultants, Room 182, Pine Hall, for assistance. 
The Consultant, together with the User, will examine the program deck, 
listing, and output. If the Consultant feels the problem could not 
have been prevented by the User, he will suggest a Refund Request Form 
be completed, subject to the following considerations: 


1. No refunds will be given for jobs whose total run time is 


less than 2 minutes. 


2. Jobs of greater than 2 minutes duration which run.longer than 
their time estimate may receive a refund. Refunds will only 
be given on the actual run time--minus 2 minutes--exceeding 


the maximum time specified on the J@B card. 


3. Jobs whose output exceeds the line and/or punched card 
estimates will be terminated as soon as possible. The User 


will be charged for the excess output. 


4, Users will be charged for setup time for those jobs whose 


setup cannot be completed while a prior job is running. 
5- The message option on the J#B card must have been "MSGLEVEIe1", 


Extenuating circumstances regarding any of the above items should be 
pointed out to the Consultant. 


The listing and output for the suspect run must accompany the request. 
If a system or machine error is suspected, a complete source listing 
(including a listing for all subprograms) and an interpreted copy of 
the run deck must also be submitted. 
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Written notification of the disposition of the request will be sent to 
the User as soon as possible. 


Known problems and their solutions will be announced in the Bulletin, 


and subsequent refund requests stemming from these problems will not 
be considered favorably. 
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2.1.4 Campus Facility Personnel Directory 


The following directory provides a handy list of telephone numbers which 


are relevant to users of the Campus Facility. 


NAME TITLE/ FUNCTION 

Briggs, Norman R. Head of Procurement and 
Plant Office 

Bruguera, Jorge Head Librarian, Computer 
Science Library 

Fredrickson, Roderic Associate Director, Campus 
Facility 

Gilman, Patricia User Services Manager 

Hagan, Helen Asst. Accountant (job 

numbers, acct. information) 

Jensen, Eileen Systems Documentation Office 

Konrad, Dianna Publications Processing 
Coordinator 

Lieberman, Mark Assistant Director, Campus 
Facility 

McGowan, Cecile Secretary, Campus Facility 

Associate Director's Office 

Montgomery, Richard Operations Manager 

Smith, Karen Polya Hall Receptionist/ 
Information 

Vesanovic, Peter Operations Supervisor 

Wood, Connie Keypunch Supervisor 

Consulting 


Recorded message regarding machine 
and job status 


Operations -- general inquiries 
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LOCATION 


Polya 108 


Polya 170 


Polya 109 


Polya 156 


Polya 164 


Pine 185 


Polya 153 


Polya 105 


Polya 107 


Pine 186 


Polya 


Pine 188A 


Pine 188H 


Pine 185 


EXTENSION 


4372 


2894 


2897 


4400 
47.95 


4877 
437% 


Oks 


2897 


4873 
2895 


439) 
4395 


2046 
4391 


4392 


2.2 Equipment 


2.2.1 Hardware 


Revised February 1968 


The Campus Facility IBM 360/67 incorporates the following components: 


° 


1°] 


12) 


° 


One Central Processing Unit 
786,432-bit bytes of core storage 
Two 7-track tape drives 

Two 9-track tape drives 

Two 2314 Disk Storage Units 

Two 1403 Printers 

Two 2540 Card Read/Punches 

Two 2501 Card Readers 

Two 2702 Transmission Control Units 


Appropriate control and console equipment 


See Figure 1.3 for a complete configuration of the 360/67. 
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(2.2.2 Unit Record Equipment 


Necessary unit record equipment is available in Pine Hall, and may 

be operated by Users to prepare and correct punched cards and list, 
interpret and duplicate punched card decks. Brief operating instruc- 
tions appear below. The personnel in Dispatch will be happy to assist 
the User in learning how to use and operate the machines. _A word of 
caution -- in the event of a card jam or machine failure, contact a 
Dispatch clerk immediately and do not attempt to clear the failure or 


jam. 


1. 519 Reproducing Punch 


Read Punch 
Feed Feed 


Operating. 
Controls 
and 
Indicators 


Read 
Stacker 


Comparison 
Indicator 


Control 
Panel 
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Register with a clerk at the Dispatch counter in Pine Hall for use of 
the 519 Reproducing Punch. The power switch is controlled from the 
Dispatch area. Notify the Dispatch clerk when your work is completed 


so that the unit can be turned off. 


To duplicate a deck, place the source cards into the READ FEED with the 
top of the cards face down and toward your right. In the same way, 

place a supply of blank cards in the PUNCH FEED. Open the CONTROL 

PANEL cover, insert the 80 X 80 DUPLICATE Control Panel and then reclose 
the cover. Control panels should be handled with care. Hold down the 
START key for a couple of seconds. The cards will begin feeding and 

will fall into their respective STACKERS, Always stop the machine to 
replenish the blank card or source card supply. When the last source 
card has been read, remove the remaining cards from the PUNCH FEED and 
hold down the START key a few seconds until all cards are in the STACKERS. 


Cards can be duplicated in columns 1-76 and punched with new sequence 
numbers in columns 77-80. On the Col. 1-76 DUPE and 77-80 NEW SEQ Con- 
‘trol Panel select the switch setting desired: count by units or count 
by 10's, On a blank card, keypunch the starting number you want in your 
deck into columns 77-80. Put this card in front of your blank card 
supply and then load and operate the machine as explained for 80 X 80 
duplicating. WARNING: The 519 Reproducing Punch cannot be used to 


reproduce binary cards. 


For comparing, the "Compare" Control Panel is used. The master deck is 
put in the left-hand feed, and the reproduced deck in the right-hand 
feed. The machine will stop and the red "ERROR" light will glow, if a 


discrepancy is encountered. 
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2. 557 Interpreter _ 


Print Position 
Dial 


Card 
Hopper 


Entry 
Switch 


Stacker- 


Control 
Panel 


The. interpreter reads ‘information punched into a card and prints it. on. 
the card at the rate: of 100 cards per minute. Up to. 60 characters’ can 
be printed in a single pass through the machine. The remaining 20. 
characters on the card can be printed ‘on a second’ pass. ‘Printing’ can 
‘be positioned on ‘the: card on a any ¢ one of. 25: lines. This machine is not 


Revised May 1968 


Operating Instructions 


° 


° 


Register with a clerk at the Dispatch counter in Pine Hall for use 
of the 557 Interpreter. The power switch is controlled from the 
Dispatch area. Notify the Dispatch clerk when your work is com- 
pleted so that the unit can be turned off. 


Verify that the proper control hoard is in the machine. 


Joggle the cards into perfect alignment and place them face down 
in the hopper with the 12-edge inward (to the left). 


Set: the printing position control (the clear plastic knob with 
numbers on the edge) to the desired print line. Line no. 1 is 
above the 12-line on the top edge of the card, line no, 2 is the 
12-punch line, line no. 3 is between the 11 and 12 punch lines, 
etc. The odd-numbered lines (3 through 23) are between the punch 


lines. 


Set the "ENTRY" toggle switch at the right-hand end of the controls 
to the "UP" position for entry 1 (the first 60 characters), or the 

"DOWN" position for entry 2 (the remaining 20 characters), and push 
the black "START" button. 


The machine will interpret the punches in the cards which will 


emerge in their original order in the stacker, 


The machine will stop automatically when the final card has been 
interpreted, when the stacker is full, if the feed mechanism fails 
or if the "STOP" button is pushed. 


A special control board is provided for interpreting binary cards. 
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Pockets hp Hopper 


Column-Selector 
Knob 


Machine Controls 


Sort-Selection 
Switch 


“. Digit-Suppression 
Keys . 


Main-Line 
Switch 


The sorter arranges punched cards in either alphabetical or numerical 


sequence, sorting a single column at a time. 


Operating Instructions 


o- Register with a clerk at the Dispatch counter in Pine Hall for use 


of the sorter. The power switch is controlled from the Dispatch area. 


o After a 60-second warm-up period, press the "START" key to clear the 


machine of any cards left by the previous user, 


o Joggle the cards into perfect alignment and place them in the hopper 
at the right-hand end of the machine, then put the card weight on 
top of the stack. The cards must be face down with the 9-edge 
toward the throat (left). | 


o Press the "START" key until the machine starts feeding cards from 
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the bottom of the stack. Each card passes under the brush head, 
which determines which of the 13 stacker pockets will accept it. 
There is a pocket for each punch position in the card, and a reject. 


pocket for cards without a valid punch in the column being sorted. 


o Ifa jam occurs, ask the Dispatch clerk for assistance -- do not 


attempt to clear the jam yourself. 


o The machine will stop when a pocket is full, when the hopper is 
empty, when the cover over the brush is raised, or when the "STOP" 


key is pressed. 


re) Notify the Dispatch clerk when your work is completed 80 that the 
unit can be turned off. 


Operating Features 
SELECTOR KNOB 


STOP 
RESET | 


 feTe Te Te Ts TeTs Tet Totnfa) 


4 COUNT SORT 
CTRS ONLY SUPP 
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o Digit-Suppression Keys - The twelve digit-suppression keys correspond 
to the twelve punching positions on an IBM card. To select from a 
file all cards that have any specified punch or punches in one column, 
suppress sorting of these punches by pressing the corresponding digit- 
suppression keys. When pressed, the keys automatically latch down. 

To unlatch or reset the keys, run a fingertip along the bottom edge 
of the keys. 


o Sort-Selection Switch - A 5-position rotating switch determines the 
sorting pattern: Numerical, Zone, Alphabet ic-Sort 1, Alphabetic- 
Sort 2, or Alpha-Numerical. Figure 2.2a on page 2-12b shows the 
sorting pattern for each setting of the sort-selection switch. Blanks 
fall into the reject pocket on every setting. 


Numerical’ (N): Cards are sorted on the first punch that is read. 
Double punches fall into the reject pocket as errors if the edit 
switch or edit-stop switch is on. 


Zone (Z): Cards sort on zone (0, 11, 12) punches only. Cards with- 
out a zone punch fall into the reject pocket. Any card with more 
than one zone punch in the column being sorted falls into the reject 
pocket as an error if the edit switch or edit-stop switch is on, 


Alphabetic-Sort 1 (Al): Cards punched with a digit and a 12-zone 
(letters A through I) sort on the digit punches (1 through 9). 
Cards with an ll-zone punch fall into the ll-pocket. Cards with a 
zero punch fall into the zero pocket. Cards with only a digit punch 
and cards with only a 1@-zone punch fall into the reject pocket. 
If the edit switch or edit-stop switch is on, cards with multiple- 
digit punches or multiple-zone punches fall into the reject pocket 
as errors. 


Alphabetic-Sort 2 (A2): Cards punched with an ll-zone and a digit 
(J through R) or a zero-zone and a digit (S through Z) sort on the 
digit punches. Cards with a zero or ll-punch only, cards with a 
digit punch only, and cards punched with letters A through I fall 
into the reject pocket. The error condition is the same as Al. 


Alpha-Numerical (AN): Cards with a digit punch (0-9) but no zone 
punch fall into their respective digit pockets. Cards with an 
li-zone punch fall into the ll-pocket; cards with a 12-zone punch 
fall into the 12-pocket; cards with a zero-zone punch fail into 
the reject pocket. The error condition is the same as Al. 

o Edit Switch - With this switch on, errors fall into the reject 
pocket without stopping card-feeding. 


o Edit-Stop Switch - With this switch on, errors fall into the reject 
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pocket, the error light comes on, and card-feeding stops. To reset 
the error circuits when the machine has stopped and the error eee is 


on, press the stop-reset key. 


Oo Sort-Test Switch - To check machine timing, the customer engineer sets 
this switch to Ee Set the switch to "SORT" for sorting opera- 
tions. 


o Edit Light - When the edit-stop switch is on and the machine senses 
an error, this light comes on. It also comes on when the test-sort 


switch is set at "TEST" and the brush is reading a punch in the card. 


Oo Power-on Light - This light glows when the main-line switch is on and 
the machine is ready to operate. 


Oo 8 Stop-Reset Key - Press this key to. stop card~feeding or to reset the 
error circuits when the sorter has stopped with the error ‘Light on, 


SORT 
SELECTION 
SWITCH 
SE TTING 


ERRORS (When 
Edit or Edit-Stop 
isON) ‘ 


:Adcliiclet placed 

cards (incl. letters) 
Any card without | Any card with more 
@-Zone punch than one zone punch 


Blanks and cards 
with a 12-zone 
punch but no digit 
punch, Digits 1 
to 9, 


Cords with 0 or 
ll-zone only. 

Blonks. Letters A 
to 1, ond 12-zone 


REJECTS . 
REGARDLESS 
OF EDIT 


than one zone punch 
or with more than 
‘| ne digit punch 


Some os A-] 


Figure 2.24 


2+12b 


Any cord with more |. 


ea te 


~~ oy 
aL i 


ramsey Wes errenteite 
py ee 4 
‘ 3 


2-13 


Q 
Ww 
E 
R 
T 
Y 
A 
s 
Lf) 
F 
G 
H 
Z 
x 
Cc 
Vv 
B 
N 
P 
/ 
y) 
1 
oO 
J 
K 
L 
M 
‘ 


BSZSSRBBUKB 
BI OON OM RW Opa I 


AN+*2 61 
+ ws 


Key Graphics and Punched-Hole Codes 


Cards can be punched under "manual" control or " program" contol. 
"Program" controlled punching is advisable when preparing a large 
number of cards all with a similar format. "Manual" punching is 
Simple and is recommended when a few or randomly formatted cards 


are to be prepared. 


Manual Control Punching: 
a) Put the supply of cards to be punched into the hopper on the 
upper right-hand sidé of the machine, 
b) Turn the three switches "AUTO FEED" ,"AUTO SKIP", "AUTO DUP", and 
"PRINT" to the "ON" position. 
¢) Press the "FEED" key at the right of the keyboard twice. This 
will bring down two cards. The first card is ready for punching. 
ad) If you punch through col. 80 the machine will automatically 
eject the card punched, position the next card for punching and 


feed another card. 
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g) 
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If you want to eject a card before reaching col. 80, manually 
press the "REL" key. 

When punching a very few cards, you can insert cards.into the 
punch station at the right of the machine. Press "REG" and 
begin punching. 

To duplicate a card, put a blank card in the punch station and 
the source card in the read station (to the left) and then press 
"REG", Next, hold down the "DUP" key for continuous duplicating, 
or use the "DUP" key to duplicate column by column. This pro- 


cedure is commonly used to correct punching errors, 


Program Controlled Punching 


Preparing a "program" card. In the program control mode, the 
program card controls the format of the cards and the characters 
(alphabetic or numeric) to be punched. 


1) Program control symbols 
1 This punch allows punching of alphabetic characters 
b =A blank column allows punching of numeric characters 


O This symbol] causes duplicating from the column at 
the read station to the column at the punch station 


- This code causes the card to skip 


& A & symbol in each column in the field, except the 
first, defines a field. 
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2) This example of a program card shows all common combinations 


of codes and their resultant products. 


&~-2 8-821 6A Pee RR ee ee eee ERE eke eee Bee Re Re Be eee ReRe Ree dakdsiaiabaan Re eee Ree eee 7 To 
0 ood “O | | | 


ee 


000000 
29-45 07 8 8 10-10 12 £5 14 15 16 17 80 10 20-21 22 23 26 25 26 27 78 25 30 31 32 33-34 35 36 37 38 39 4041 47 69 44 45 48 47 48 49 56 51 $2 53 54 55 56 57 SB 59 GO 6 67 63 64 65 65 67 68 69 70 71 12 7914 25 78 27.78 78 80 
tytadd 


TED ULETE ERROR RESO RR ERS REE ERORERRER ODS REEREEOROROETRRREEEROREOEEEEEEOCOSESS 
22 2([}22222222222222222222222222222 2222222222222 2222222222222 22222222222222222222 


0 0 the "program" card 
0 
iy 
1 


000000000 OOODDNHNDODOOO NOS DDDON ODDO CONN ODOC HONDO DONNNDD ONAN DDNNNODNNLD 

1G 9 10 08 12 43 16 15 W6107 18 ¥0 20 20 22 29 26 25 26 27 20 20-98 38 32 39:36 95 36 37 98 3940-41 42 43 44 45 46 47 4B 49 50 51 52 53 54 55 55-87 $8 58 60 6T 62 6360 65 68 67 G8 68 70-71 72.73 7415 78 77 78 79 98 

RRR R DR SRR RRO ROR ROSS SSSR RRR OC ERRORS OSE RREE OSES EASES OSEERSERRERREREEL 
22222222 2(}22[}2224222222222222222222222222222222222222222 22222222222 2222222222222 


9333[]33333[]339359339939533399933599939999339993939399933993993939993333993333939 


PYYSERERECEINEYUSIECLUOOUOVIVICETTVYVYVITYLere re rerer rere rye ey errr reer ey erty yey 
§5555555555555([]55555555555555555555555555555555555555555555555555555555555555555 
BUG GEOEGECEGE[JEGEESSECSSGESGSSSSESSGEOSSSSSECSSEOSEOSESESSESSSESSSSSSESSESSSESEO 
HEE ERRER EERE EEE EESELEEISEISEISELSEYEREEELELLELILISEIEE SEI SELEELIELISEL 


Se ee 
999999999999999999999999999999999999999999999999999999999999 
I 


on a oeeerina 20 21-22 23 24 25 36 27 28 20 90 31 52 30-04 35 36 37 38-30 4041.42 43 44 46 46 40 48 49 50 51 527 59.84 56 BE 57 BO 58 60 61 62 69 04.65 04 67 68 6069709 
soat u 


o The keypunch is designed for punching and duplicating only those 
characters contained on the keyboard. Heavily coded cards (e.g., 


cards with more than 3 punches per column) cannot be duplicated | 
on the machines. 


o Please remember to consider the. other users and clean up the ma~ 
chine before leaving it. Dispose of cards in a nearby "CARD 
‘disposal can." 


{ o See the Keypunch Supervisor for assistance with meypunch: nachines 
and. to report’ failures. 
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2.5 Operational Procedures 


The computers, related equipment, and ebexiti we Group are ‘located in 
Pine Hall. These facilities are open and staffed 24 hours a day, seven 
days a week, including holidays. The Operations Group is responsible 

for the operation and maintenance of the equipment ‘and also offers many 
related services and facilities. The Group is headed by the Operations 
Manager who is located in Room 186, Pine Hall, extension 4873. The 
Operation Supervisor is responsible for smooth operations and workflow. 
He is located in 188-A Pine Hall, extension 4394, This office is con- 
tinuously staffed, and all special Operations requests or Drobene should 
be brought here. 


At the Dispatch counter, Operations personnel handle input and output 
to the computers, assign lockers and output bins, and generally assist 
with the user's operations needs. Users with programming questions. 
should go to the Consultants Office, Room 185, Pine Hall. 


The following sections describe details of the facilities and services 
provided for the user. These sections are intended to give the user 
sufficient information to use these services and faqilities. Additional 
information and assistance can always be obtained by contacting the 
person in charge or the personnel in Dispatch. 


The Computation Center invites your comments and suggestions regarding 
the facilities and services offered, Your comments will be studied and 
a reply will be sent through the User Services Office. Forms for sub- 
mitting suggestions (see Figure 2.3) are available at the Dispatch 
counter and the Systems Documentation Office. 


2-]7 


COMPUTATION 


CENTER 


The Computation Center invites your comments and suggestions, general and specific, regard- 
ing the facilities and services offered. Your comments will be studied and a reply will be sent 


through the User Services office. 
USER COMMENT. 


NAME FORM 
CHARGE NO... —sssS<=~BIN NN. . 

MAIL ADDRESS: | DATE 
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2.3.1 Service Schedule 


WEEKDAYS 


00:01 
04:01 
08:01 
09:01 
17:01 
20:01 


00:01 
04:01 
08:01 
09:01 
18:01 


WEEKENDS 


00;01 
06:01 
08:01 
12:01 
18:01 


00:01 
06:01 
08:01 
12:01 
18:01 


to 
to 
to 
to 
to 
to 


to 
to 
to 
to 
to 


to 
to 
to 
to 
to 


to 
to 
to 
to 
to 


Note 1: 


Note 2: 


Monday thru Thursday 


04:00 OVERNIGHT SERVICE BLOCK 
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WYLBUR 
Service 
Available 


No 


08:00 Hardware maintenance period, No 


09:00 Machine start-up period. 


17:00 PRIME SERVICE BLOCK. 


No 
Yes 


20:00 Software maintenance period. No 


00:00 EVENING SERVICE BLOCK, 


Friday 


04:00 OVERNIGHT SERVICE BLOCK, 


Yes 


08:00 Hardware maintenance period. No 


09:00 Machine start-up period. 


18:00 PRIME SERVICE BLOCK. 


00:00 Engineering change period. 


Saturday 


06:00 Engineering change period. 
08:00 Machine start-up period. 


12:00 PRIME SERVICE BLOCK, 


18:00 Software maintenance period. No 


00:00 EVENING SERVICE BLOCK. 


Sunday 


06:00 OVERNIGHT SERVICE BLOCK. 
08:00 Machine start-up period. 


12:00 PRIME SERVICE BLOCK. 


18:00 Software maintenance period. No 


00:00 EVENING SERVICE BLOCK, 


Self-Service 
Card Readers 
in use 


No (Note 1) 
No 
Yes 

o (Note 2) 
Yes 


Yes 
No (Note 2) 
Yes 


There is no Friday overnight scheduled for Saturday morning. 
If the machine is not required for the stated purpose a 
block will be scheduled. Notice will be made in Pine Hall 


and on the recorded message. 


There is no service block scheduled for Saturday or Sunday 
afternoon. If the machine is not required for the stated 
purpose, a service block will be scheduled. 


Notice will be 
made in Pine Hall and on the recorded message. 


Special service scheduling for such things as weekend insti- 
tutes should be discussed with the Associate Director, 


Campus Facility. 
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2.3.2 Job Flow 


This procedure will be used during the Prime and Evening Service Blocks. 
Users should check any posted notices in the Dispatch area to see if 


there is a change in this procedure. 


1. Enter your own decks: 
The user enters his job directly into the system by the two 
card readers provided. These jobs are queued on disk and 


then executed according to the current scheduling algorithm. 


2. A service card is NOT required unless you have tapes or need 
to give special information to the operator: 


The service card should not be entered into the system. 
Note: If your job requires tapes or any other special 
service, a service card should be presented to 
the operator at the window in the card reader 


room before you enter your program deck. 


3. Output: 
Output will be returned to your bin. Slight delays may be 


caused by requests for punched cards. Input card decks left 
for overnight runs are returned to the trays on the dispatch 


counter. 


4, Expected turnaround time: 


This is highly dependent upon inter-~arrival time at the card 
readers and, of course, on the number and time estimates of 
the jobs submitted. 


5. TV Monitor of job progress: 


A TV monitor is provided to show you the progress of the sys- 
tem as it works on the job stream. You should observe the 
number assigned your job by the system. (It is started at 1 
at the beginning of the block.) By comparing your number with 
the number of the job currently in execution, you can estimate 
when your job will be out. 
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6. WYLBUR terminal used to display system status: 
The WYLBUR terminal in the 360/67 card reader room is for the 


convenience of persons entering their jobs into the system using 
the card readers. With this terminal, users may issue the 
following WYLBUR commands to determine system load and to locate 
jobs which are in the system: 

COMMAND ? show status shows the current workload on the 


360 in terms of the jobs being exe- 
cuted and the jobs awaiting processing. 


COMMAND ? show run returns the number of jobs awaiting 
execution by priority. 


COMMAND ? show print returns the number of jobs awaiting 
print by priority. 


COMMAND ? locate n where n is the system assigned job 
number for your job. 
The user may also use the LOCATE command to search for a job 


by its job name rather than its job number. 


COMMAND ? locate fire 

JOB NAME - FIRE - NOT FOUND 

In the above example the job name specified was not found by 
the system. Either the user entered the wrong name (spelling 


error?) or the system had completed all action for the job. 


COMMAND ? locate newfixl 

JOB NAME -NEWFIX1 - IS JOB NUMBER -  57- 

JOB 0057 IS AWAITING EXEC 

In this example the system reported back both the job number 
and the status of the job having the name NEWFIX1. 


When the system finds more than one job with the same job name 
it will report the job number of all and give the status of 


the last (highest numbered) one. 


7. Special Runs: 


Requests for "Scheduled Programmer Present" runs should be 


directed to the Dispatch Desk or call Ext. 4392. 
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8. Assistance with large decks (in boxes): 
Users with large decks should request assistance from one of 
the dispatch clerks. An operator will read your deck in using 
one of the operator card readers. Your cards will be returned 
to you on the shelves in the lobby. 
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2.3.5 Keypunch Service 


The Campus Facility maintains a Keypunch Section staffed by qualified 
personnel to handle all keypunching needs. The current rate for this 


service is listed in the Rate Schedule in Section 2.1.2 of this manual. 


The Keypunch Section is located in 188 Pine Hall, extension 4395. Hours 
of operation are 8 a.m. to 4 p.m., Monday through Friday. Completed 
work is left in a central bin so that it can be picked up by the user 


at anytime. 


The Keypunch Supervisor can provide assistance in the preparation and 
coding of documents to be punched. It is recommended that users who 
plan to use the keypunch service consult with the supervisor in the 
document design stage. Planning for the keypunching step in this early 


stage can mean less expense later. 


2.3.4 Special Services 
Decks can be left at the Keypunch Section for reproducing, interpreting, 


and other special services. The current rate for these services is 


listed in the Rate Schedule in Section 2.1.2 of this manual. 


e-el 


2.3.5 Magnetic Tape Library 


The Tape Library, located in Dispatch, Room 188, maintains a supply of 
tapes which may be reserved by the users. SCC tapes may be reserved 


by any Center user with a valid charge number. 


The user can reserve an SCC tape by filling out and submitting a Tape 
Request Form (Figure 2.3), which is available at the counter in Dispatch. 
A tape will be reserved in the user's name and the operator receiving 
the tape request will recora the tape number on the request form and 
return the stub to the user. When the user wishes to release an SCC 
tape reserved for him, he may either sign the request form on file in 
Dispatch, or sign his name on the request form stub and send it to the 


Tape Librarian. 


Tapes owned by the user can be entered in the Magnetic Tape Library by 
submitting the tape to the Tape Librarian and filling out a Tape Request 
form, A number will be assigned to the user's tape and entered on the 
portion of the request form which he retains. User-owned tapes will 
only be released to the user in person. 


A small charge is made for the storage and handling of both user-owned 


and SCC reserved tapes in the Tape Library. 


SCC tapes are cleaned periodically according to a standard schedule; 
in addition, it will be cleaned and certified at the user's request, 
User-owned tape will be cleaned and certified at the user's request. 


The Tape Librarian can be reached at extension 4392, 
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TO RESERVE A TAPE, FILL IN 
THIS BLOCK ONLY AND 
SUBMIT AT COUNTER: 


[7090 Cless00 CI 
DENSITY 200 556 800 16900 


Name 
Label 
- Com 


Charge 
No. : 


Stanford Computation Center 
TAPE LIBRARY REQUEST 


50-01-21 tam Leneve 


IM 


RELEASING SIGNATURE 


Figure 2.4 
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TO SE DETACHED BY BOO PEREONNEL 
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YOUR REEL 


DATE RESERVED > 


This stub will be returned to you by the 
Librarian. Use the space below to identify 
tape contents for your records. 


ISSUED 


8Y: 
Stanford Computation Center 
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2.4 User Services 


The User Services Group is comprised of full-time professional programmers 
‘who are responsible for providing assistance to the user community. The 
specific areas covered by this group are consulting, education, documen- 


tation, and programming assistance. 


2.4.1 Consulting Services 


The consulting service is intended to help the user get his program run- 
ning in the shortest possible time. The consultant is able to answer any 
question regarding job setup, job control language, FORTRAN, PL/1, the 
interpretation of diagnostics and dumps, tape handling, the creation and 
deletion of temporary and permanent data sets, the use of library facili- 
ties, and requests for time adjustments due to operator, system, or hard- 
ware failure. In short, consultants should be able to answer, or find 
the answer, to any question regarding hardware and programming systems 


supported by the Campus Facility. 


While the consultant can often indicate where a problem may Lie, he is 
not expected to write, debug, or rewrite programs. The consultants are 
specifically prohibited from advising the user as to which technique ‘or 
method should be used to solve a problem. After the user has made a de- 
cision, however, the consultant may then indicate which available rou- 
tines perform the necessary calculations. The user is advised to seek 
directions early in the developmental stages of a research project. 


Assistance in designing questionnaires and coding sheets is available. 


The Campus Facility Consultants are on duty Monday through Friday, 
9:00 a.m. - 12 noon and 1:00 p.m. ~ 5:00 p.m., in Room 185, Pine Hall. 


2.4.2 Educational: Activities 


The current educational effort centers around FORTRAN IV, described in 
the publication IBM System/360 FORTRAN IV Language, Form No. C28-6515. 
Several short courses are offered each quarter. These courses assume 

no previous programming experience, and provide the student. an opportun- 
ity to learn enough FORTRAN to write simple programs and run them.on the 
360/67. The student is also introduced to Job Control Language to enable 
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him to use the standard catalogued procedures described in the IBM System/ 
360 Operating System FORTRAN IV (H) Programmer's Guide, Form No, C28-6602. 


Courses in Job Control Language (described in the publication IBM System/ 
360 Operating System Job Control Language, Form No. C28-6539) are offered 
on a regular basis. These courses cover basic Job Control Language and 
give the student sufficient information about the 360/67 system to enable 
him to write his own job control statements for special programming appli- 


cation. 


Assembly Language Programming (described in the publication IBM System/360 
Operating System Assembler Language, Form No. C28-6514} is taught at least 
once each quarter. Although no previous programming experience is re- 
quired, a working knowledge of Job Control Language is necessary. Famili- 


arity with scme programming language is helpful. 


Siminars are scheduled on Wednesday of each week, 3:30 - 5:00 p.m., in 
Room 111, Polya Hall. Special topics such as the use of plotting rou- 
times, Library facilities, data-set handling, conversion of seven-track 


tapes, etc., are covered. 


The course and Seminar schedule is published in the Campus Facility 
Bulletin. This schedule is also available in Room 185, Pine Hall, and 
the User Services Office, Room 156, Polya Hall. 


2.4.3 Documentation 


Documentation for all of the services supported by the Campus Facility is 
available from the Systems Documentation Office, Room 185, Pine Hall. 
Abstracts for the subroutines in the Stanford Extrinsic Program Library, 
the IBM documents for the System/360, and the Campus Facility Users Manual 
are among the available materials. Reference copies of these materials 
are located in the Computer Science Library and in the Study Room located 


off Pine Hall’s Dispatch area. 


New facilities, changes or problems in existing facilities, short courses 
and seminar schedules, and policy announcements are communicated to the 
user community through the Bulletin. Users are urged to subscribe to this 
publication by submitting their name and address to the Systems Documen- 


tation Office, Room 185, Pine Hall, Ext. 4877. 
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The Users Manual is supplemented by the Bulletin and is revised as 


needed. Revisions are mailed to holders of the Users Manual. 


2.4.4 Programming Services 


Users are encouraged to write their own programs, and to use the avail- 
able library facilities for solving their problems. However, the User 
Services Group may, on occasion, develop programs to solve an individ- 
ual user's particular problem. The user will be charged for the machine 
and programmer time required for this type .of development. Users de- 
siring this service are asked to discuss their project with the super- 


visor of the User Services Group, Room 156, Polya Hall. 


%. COMMUNICATION WITH THE COMPUTER 


3.1 Operating System (0S) 
The IBM System/360 Operating System introduces programs to the computing 


system, initiates their execution, and provides them with all the re- 
sources and services necessary for them to do their work. To be effective, 
the operating system must be general enough to accommodate a variety of 
applications on a wide range of hardware configurations. It is, there- 
fore, made up of a general library of programs that can be tailored to 
meet many requirements. The user can select those portions that he 

needs, add his own procedures to them, and update his procedures as his 


needs change. 


For illustration purposes, the programs and routines that compose the 
operating system are classified as a control program and processing 
programs. The three main functions of the control program are to accept 
and schedule jobs in a continuous flow (job management); supervise on 
either a sequential or parallel basis each unit of work to be done 
(task management); and simplify retrieval of all data, regardless of 
the way it is organized and stored (data management). The processing 
programs consist of language translators (such as the FORTRAN compiler), 
service programs (such as the Linkage Editor), the problem programs 
(such as User programs). The processing programs are used to define 
the work that the computing system is to do and to simplify program 


preparation. (Figure 3.1 shows the operating system elements. ) 


The most important feature of the operating system is its unity. This 
unity establishes a direct line of communication between the user and 
the operating system and, within the system, between the control program 
and the processing programs. The net result of this effective communi- 
cation is a reduction in the time from submitting a problem to receiving 


a solution. 


ALAN AICHER 


Revised May 1968 


Operating System Elements 


Control Program Elements 
Job Task 
Management Management 
Data 
Management 


Languages Service Application 
Programs Programs 


AIGOL 
Assembler 


Independent 
Utilities 
Data Set 
Utilities 
System 
Utilities 
Linkage 
Editor 
Sort/Merge 
TESTRAN 


User 
Written 


Figure 3.1 
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3.1.1 HASP 

The Houston Automatic Spooling System (HASP) is a specialized program 
which performs the peripheral functions normally associated with offline 
support computers. It has the ability of operating an essentially un- 
limited number of peripheral devices (i.e., card readers, punches, printers) 
concurrently and in conjunction with 08/360 processing. The user does not 
program with HASP in mind -- it is actually transparent to the user. How- 
ever, the information that appears on the header and trailer sheets of 
your output; the accounting information gathered for your job; the assign- 
ing of a job number for your job; the checks for line, card, and time 
estimates; the priority system and several other related features on the 
360/67 are all produced and controlled by HASP. 


HASP performs these functions and operates the peripheral devices by 
"stealing" small amounts of CPU time. In fact, HASP only uses six 
minutes of processor time in an average twelve hour service block. A 
better understanding of HASP and its major functions can be obtained 
from the following description of a job (a FORTRAN job with data cards 
in the deck, for example) and its flow through the system. 


HASP starts by reading a job from one of the card readers. At this point 
HASP inspects the job card for validity and records any special services 
requested, such as tape setup or multiple-part forms. If the Job card 

is in proper format HASP then "spools" the deck onto a disk for storage 
until this job is to be executed. At execution time the job is read in 
from the spooling disk and submitted to the OS processor (and thus to 

the FORTRAN compiler, linkage editor, etc.). During this execution phase 
any requests by the job for the card reader (probably a request for the 
data), the printer, or the punch are given to HASP rather than the actual 
physical device. HASP spools the output (FORTRAN compiler listing, stor- 
age map, etc.) to disk as it is processed by OS and reads in the data 
cards entered earlier with the job. At the end of OS execution, this 

job is scheduled for printing and the next job is submitted to the OS 
processor. After the job is scheduled for printing, the job enters the 
punch phase. After the punch phase the job is "purged," i.e., HASP 


erases the entry for this job from the job table and makes room for 
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another job to be read from the card readers and spooled to a disk. 


The above example follows one job through the four major processing 
stages in HASP. What is not apparent from the example is that while 

one job is in the execution phase, other jobs are concurrently being 
read into the system, punched, or printed. The number of jobs in these 
last three stages depends on the number of peripheral devices available. 
Currently at the Campus Facility, different jobs can be read in from 4 
card readers, punched on 2 punches, and printed on 3 printers all simul- 
taneously and while still another job is being executed by OS. HASP, 
therefore, increases throughput by giving this job-to-job continuity and 


by making efficient and continuous use of the available peripheral devices. 
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3.2 Job Control 


Job processing requires that the programmer communicate with the opera- 
ting system. The language used for this communication under Operating 
System/360 (6S) is the Job Control Language (JCL). JCL provides the 
operating system user with a means of influencing the execution of 

work and the allocation of system resources, in addition to transmitting 
control information. Because the information can be submitted on devices 
other than a card reader, the elements of the language are called 
“control statements” instead of control cards. (Users of other opera- 
ting systems are familiar with the necessity of supplying special control 
cards to set up their jobs properly; JCL control statements serve the 


same purpose under @S. ) 


3.2.1 Job Control Statements 
There are four JCL statements that concern the user. They are: 


1. The JOB statement marks the beginning of a job and precedes 
all other statements in the job. It identifies the user and 


his job. 


2. The execute statement (or EXEC statement) is the first control 
statement in each job step -- it identifies the program to be 


executed or the catalogued procedure to be used. 


3. The data definition statement (or DD statement) describes a 
data set (a file on tape, disk, or a deck of cards) and re- 


quests the allocation of input/output devices. 


4, The delimiter statement (/*) marks the end of a data set in the 
input stream. It is used to separate the data set from subse- 
quent control statements. It is analogous to the "end-of-file" 


statement in other systems. 
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3.2.2 JOB Statement 


Format: 
// aanaaaaarIPBA( bbbb, ccc, ddd.d,eeee, ffff,g,hh,s,x), "Your Name' ,MSGLEVEIe=1 


Where: 


aaaaaaaa = job name (1 to 8 characters, the first of which must be alpha- 
betic). Don't use special characters in the job name. 


bbbb = your account number (1 alphabetic character followed by 3 
numeric characters). Users submitting jobs under invalia 
account numbers will be flushed and a message "ILLEGAL ACCOUNT 
NUMBER' will be printed on the 1443 printer, 


cece = your bin number (% numeric characters), 


ddd.d = time estimate. Up to three digits to the left of the decimal 
point and up to one digit to the right of the decimal point 
are permitted. The field is read as minutes and tenths of 
minutes. The following configurations are legal: 


12h 12h, 124.0 ah.3 0.3 3 


eeee = your estimate of printed output - lines ~- in thousands (1 to 
4 numeric characters) 5 = 5000. 


ffff = your estimate of number of cards to be punched (1 to 4 numeric 
characters). If this field is omitted, 100 cards is assumed. 


g = number of parts in form you want your printed output on 
(1 numeric character). If this field is omitted, single part 
paper is assumed. If a digit higher than 1 is inserted in 
the g field, the program will automatically be placed in 
hold state at print time. The desired part. paper will be put 
on the printer and the output will be printed at the discre- 
tion of the operator. - ' 


hh = number of copies of printed output desired (1 to 2 numeric 
characters). If this field is omitted, 1 copy is assumed. 


s = insertion of the letter s in the eighth field indicates 
that a tape is to be mounted. When the Job is card to 
disked it is automatically placed in hold status. The 
Operator mounts the tape and releases the job for execution 
giving consideration to efficient throughput and fast turn- 
around time. This feature eliminates wasteful entry into 
wait state while tapes are being mounted. You must continue 
to fill out tape mounting information on the number 1 card, 
Jobs which do not have s in the eighth field of the job 
card will be canceled by the operator. 
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= An insertion of the letter X in the ninth field of the job 
card will cause page ejects to be supressed during the go 
step, thus permitting users to print across page margins. 


Symbol definitions: 
' indicates an apostrophe (single quote). 


A indicates 1 or more blanks - otherwise no blanks. 
All control statement information must start in column 1. 


The job name is used by both the Operating System and the 360 
Operator to distinguish between jobs. It is important that no 
two jobs with the same name be present in the system at any 
one time. (Imagination in naming your jobs will help eliminate 
potential problems. Avoid such common job names as TEST, JOB, 
RUN1, etc. ) 


The total line count will include a count of all messages from 
the Operating System and any language processors used in the 
job. This must be taken into consideration when estimating 


the maximum count. 


The message ***JOB TERMINATED BECAUSE OF JOB CARD ESTIMATE 
EXCESSION*** appears if your job was cancelled for exceeding 
estimated run time, estimated line count, or estimated punch 
count. A message identifying the error appears on the 1443 


printer when the error occurs during execution time. 


Requests for multiple part forms will receive an additional 
service charge. For small print jobs, the multiple copies 
option provided in the JB statement will be an acceptable 


alternative to multiple part forms. 


Multiple copies are printed on one-part paper in succession 


until the number requested is satisfied. 


The parameter MSGLEVEI-1 causes all job control statements to 
be printed as part of the user's output, including the entire 


contents of the catalogued procedure(s) used. This parameter 
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is required if the consultants are to assist you with any 


problems you may have in using the system. 


9. The following information appears on the tail sheet of your 


printed output. 


NNN 1/O CALLS This is the total number of I/O calls 
made from your partition to the drums, 
disks, or tapes during execution of 
your program. 


TIME = NN: NN: NN This is the time of day in hours, 
minutes, and seconds at the time of 
printing your job. 

This is the date on which your job 
was run. 


DATE 


s 
S 
z 


Examples: 
1. Example of a minimum J@B statement: . 
//FIRSTGS A JOB A (Z000,999,1,1),'W. WAPDPECKER', MSGLEVET =: 1 


2. Example of a JOB statement with a 4 minute time estimate and 2 


copies of output: 
//SECENDGS A JOB A (Z000,999,4,1,,,2),'W. WAADPECKER' , MSGLEVEL=1 


3. Example of a J@B statement with a 5 minute time estimate, 5000 


lines of output, and a tape required. 


//THIRDGD A JPB A (Z0C0,999,5,5,,,8), 'WAODPECKER' , MSGLEVEL=1 
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3.2.4 Execute Statement 


Format: 
PGM=program name PARM= 'value' 
//stepnameAEXECA ’ 
procedure name PARM. procstepname='value' 
Where: "stepname" = job step identification field (optional). 
It has a maximum field length of 8 char- 
acters, alphabetic or numeric. The first 
character must be alphabetic. 
"program name" = the name of the program to be executed. 
"procedure name” = the name of the catalogued procedure to 
be used. 
"proestepname” = stepname in a catelogued procedure. 
"value" = the field for passing control information 
to the processing program (e.g., compiler 
option). The maximum field length is 40 
characters. The field should be enclosed 
in single quotes since blanks and special 
characters are allowed. 
Notes: 
1. Symbol definitions: 
' indicates an apostrophe (single quote). 
4 indicates 1 or more blanks ~ otherwise no blanks. 
fess) indicates that either of the two alternate forms 
inside may be used. 
2. All control statement information must start in column 1. 
- There is only one EXEC statement per job step. 
. If the stepname is omitted, at least one blank must separate 
the // characters and the keyword EXEC. 
5. The program or procedure name parameter must appear first in 


the operand field. 


3-6 


6. No blanks are allowed in the operand field. 
7. The PARM parameter is optional. 


8. To specify that information be passed to a step in a catalogued 
procedure, the keyword PARM must be qualified by the particular 
procedure stepname involved, i.e., PARM.procstepname. This 
specification overrides all the PARM values which have been 
catalogued in the named procedure step, if any are present. 

As many parameters of this form may be coded as there are steps 
in the catalogued procedure. (See the second example following, 
where parameter values are passed to the procedure steps named 
FORT and LKED. ) 


Examples: 

/ / AEXECAFORTHCIG 

//SEXECAPPRTHCLG , PARM. FORT= "DECK! , PARM, LKED='LET,XREF' 
/ / STEP 1AEXECAPGM=ECAP 


/ /AEXECAPORTHCLG ,PARM, FPRT='LIST,@PT=2' 


3.2.4 Data Definition Statement 


General Format: 


Format 1: 


// ddnameADDA* 


Format 2: 


//ddnameADDASYSZUT=A 


Format 3: 


// danameADDADSNAME=dsname , UNIT= 


Where: 


“ddname" 


Mog tt 


"SYSAUT=A" 


“dsname" 


device type 
symbolic name 


SER=serial number 


VpL o eset 


DCB=(data set attributes), 

LABEI=(sequence number,type), 
DISP=(status,disposition), 
SPACE=(units, (quantity, increment ,directory) ) 


DD statement identification field. Maximum field length 
of 8 characters, alphabetic or numeric. The first char- 


acter must be alphabetic. 


An asterisk (*) in the operand field specifies that an 
input data set immediately follows this card (e.g., input 
source deck to the FORTRAN compiler). 


Specifies that the output data set is to be written on 
the system output device (i.655 printed as part of the 


system output stream). 


Data set identification field. The simplest form of the 
data set name has a maximum of 8 characters, alphabetic 


or numeric. The first character must be alphabetic. 
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‘onrr" 


"VALUME" 


"data set 
attributes" 


"LABEL" 


This keyword parameter allows the user to specify the type 
on input or output unit to be used by a data set. A unit 


may be requested by specifying 


“device type" Unit model numbers of input/output 
devices in the system (e.g., UNIT=2311); 
or 
"symbolic name" Names assigned to individual units or 
collections of units (e.g., UNIT=DISK), 
(See item 3 under "Notes, Format 3" for a list of model 


numbers and symbolic names. ) 


This keyword parameter allows the user to specify infor- 
mation about the volume(s) on which an input or output 
data set will reside. The only subparameters which concern 


us here are those for making specific volume requests: 


"SER" Identifies the volume(s) by its 
. serial numbers, 

"serial number" 1 - 6 characters, alphabetic or 
numeric, volume identification field 
(e.g., VOLUME=SER=CAMP31). 

REF" Uses the same volume(s) assigned to 
an earlier data set. 

"dsname" | Defined earlier. 
(e.g., VPLUME=REF=DATASETL). 


The DCB keyword parameter allows the user to describe the 
attributes to a data set at execution time (e.g., record 
format, logical record length, block size, buffer require- 
ments). This field contains the attributes coded as key- 
word parameters separated by commas. 

(e.g., DCB=(RECFM=F,BLKSIZE=80)). 


This provides a means of describing a label for a data set. 
Specifically, this parameter must be supplied for all data 
sets residing on magnetic tape. 


5e9 


“sequence number" A 1-4 digit number corresponding to 
| a specific file on a reel of magnetic 
tape where multiple data sets ("files") 


reside on one reel. 


"type" Type of label on a magnetic tape. 

Replace "type" with: 

SL standard system label, or 

NL no label. 

Note: If the sequence number field 

is not specified, use the format 

LABEI=(, type) 
(e.g., LABEI=(,NL)). 
"DISP" This keyword parameter is concerned with 
"status" The status of a data set. Replace 

"status" with: 

OLD Existing data set. 

NEW Newly created data set. 

MOD Existing sequentially organized 
data set to be used for addition- 
al output. MOD provides a means 
by which a user can extend a 
data set beyond the last record 
previously written in the data 
set with automatic positioning 
handled by the system. 

"disposition" This indicates what is to be done with 


the data set after it is processed. 


Replace "disposition" with: 


DELETE Do not keep the data set and 


release its space. 
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“SPACE 1 


Allocate space 


access volume. 


"units" 


"quantity" 


"inerement" 


for a 


KEEP Keep the data set for later 
use. 
PASS Pass the data set to a succeed- 
_ ing step in this job. 
(e.g., DISP=(NEW, KEEP) ) 


newly created data set on a direct- 


Amount of space is requested in units 
of tracks, cylinders, or blocks. 


Replace “units" with: 


TRK for space in tracks. 
CYL for space in cylinders, or 
average block length in bytes 


for space in blocks. 


Amount of space desired in the units 
selected (e.g., SPACE=(TRK,200) for 
200 tracks or SPACE=(80,1000) for 
1000 blocks with an-.average length of 
80 bytes). 


Note: If only the units and quantity 
fields are specified, the inner level 
of parentheses shown in Format 4 

(pg. ) in the "SPACE" parameter can 
be omitted. 


Amount of additional space to be 
allocated on the same volume in case 
the data set at some time exceeds the 
total space requested. Incrementing 
by this amount may take place for a 
maximum of fifteen (15) times. 

(e.g., SPACE=(TRK,(200,100)). 
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"a@irectory" Number of 256-byte blocks to be allo- 
cated to the directory if allocating 
space for a partitioned data set 
(e.g., SPACE=(TRK,(200,100,2)). 


Notes: 


(Those items marked with an asterisk (*) are common to all three formats. ) 


Format 1 


1. No other parameters should be coded when an asterisk (*) is coded 


in the operand field. 


2. The input data set whose beginning is marked by a DD card of format 


1 must be terminated by a delimiter card (/*). 


* 43, Omission of the ddname field causes the data set to be concatenated 
with the data set defined in the immédiately preceding DD card. (See 


the Job Control Language Reference Manual for more detail. ) 


* 4, If the ddname is omitted, at least one blank must separate the // 
characters and keyword DD. 


* 5. If the job step uses a catalogued procedure, the ddname must be 
qualified by the appropriate procedure stepname, i.e., 


procstepname. ddname. 


Examples: 

/ /SYSINADDA* 

// FORT. SYSINADDA* (Specifies that the input data set to the 

| FORTRAN compiler follows this card. “Assumes 

a catalogued procedure was used and the 
stepname in the procedure which invoked the 
compiler was FORT) 

Format 2 


* 1. No blanks are allowed in the operand field. 
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Example: 
//SYSPRINT A DD A SYS$UT=A 
Format 3 
1. The keyword parameters may appear in any order and are separated by 


commas. 


If the DSNAME=dsname parameter is omitted, the data set is temporary 
and exists only for the duration of the job. This is a means where- 


by a user may define a scratch data set. 


Users are urged to use symbolic names when requesting a unit. 

Figure 3.2 is a list of the symbolic names which have been generated 
into the system and their corresponding unit addresses and device 
types. Volume serial numbers are supplied where applicable and 


should be used when a specific volume is desired. 


The UNIT parameter need not be coded if the parameter VOLUME=REF 


is specified. 


Refer to the Programmer's Guides for the language processors or the 


publication IBM SYSTEM/360 Operating System, Supervisor and Data 
Management Macro-Instructions (Form No. C28-6647) for DCB macro- 


‘instructions and operands. 


The MOD specification in the DISP parameter is changed to NEW if 


no volume information is available for the data set at that time. 


Subsequent DD cards that refer to a data set which has been passed 


via the PASS subparameter of the DISP parameter must 


(1) identify that passed data set with the DSNAME parameter, 

(2) provide unit information that is consistent with that of the 
original specification, if unit information is given at all, 
and 


(3) issue another disposition with the DISP parameter. 
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8. When allocating space for a data set on a direct-access volume, the 
user should check the capacity and organization of space on that 


particular volume. 


9. To aid in determining the amount of space to allocate for a directory 


in the SPACE parameter, each directory entry occupies approximately 


lf bytes. 


Examples: 

col. 1 col. 16 col. 72 
//DDIADDADSNAME=$UTPUT1, UNIT=TAPEQ, x 
// VOLUME=SER= 123456, LABEI=(,SL), X 
rah _ DCB=(RECFM=FB, LRECI- 80, BLKSIZE=800), x 
// DISP= (NEW, KEEP ) 

(For a data set residing on a 9-track tape to be kept.) 

/ / DD2ADDADSNAME=$UTPUT2, VALUME=REF=MYDATA , x 
[i DCB=(RECFM=U , BLKSIZE=3200), X 
// DISP=(NEW,PASS), x 
iy. SPACE=(TRK, (200,10)) 


(For a data set residing on the same volume as a previously 
defined data set, the volume being a direct-access device. 


The data set is to be passed to a subsequent jobstep. ) 
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4.2.5 Delimiter Statement 
Format: 
/* (blank) 
Notes: | 
1. The delimiter statement must be coded in columns 1 and 2. 


2. A delimiter statement must be used to mark the end of data which 
has been included in the input stream so as to separate the data 
from subsequent job control cards. (Data refers to that which is 
passed to a language processor -- i.e., a source deck; that which 
is passed to the linkage editor -- i.e., an object deck; and that 


which is read as input at execution time. ) 


3. A delimiter statement must be the last statement of the user's deck. 
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3.2.6 Continuation Cards 


The information of a control statement must be contained in columns 1 
through 71 of a card. If this information exceeds 71 columns, contin- 


uation cards may be coded according to the following rules: 


1. Complete a parameter, including the comma that follows it, at 


or before column 71. 
2. Code any nonblank character in column 72. 
3. Code the // characters in colums 1 and 2 of the following card. 


4. Continue the control information beginning in column 16. Columns 
3-15 must be blank. 


Note: For further information on control statements beyond that which 


has been covered in the preceding pages, refer to the publication 


IBM System/360 Operating System Job Control Language, Form No. 


C28-6539. 
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3.2.7 Special Control Cards 


3.2.7.1 /*LISt 


Use of the /*LIST card allows the user to take advantage of the fast 
listing service. To use this service, place a /*LIST card in front of 
your job card. This will cause the deck to be listed -- including all 
JCL cards. The listing will be bracketed by standard HASP header and 


trailer sheets. 


The “setup" and “suppress page" parameters on the job card are ignored. 
However, the "number part forms" and "number copies" parameters are 
honored by the listing service. Users are reminded to avoid using — 
job cards with “forms” and "copies" parameters unless multiple copies 


of the listing are desired. 


NOTE: Users may also obtain listings of their decks when using utility 
programs for character conversion and reproducing card decks. These 


utilities are described in Section 3.4, pg. 3-33a. 


3.2.7.2 /*RUN 


The /*RUN card is used to show priority for both execution and printing 
for jobs submitted from the card readers. A description of the use of 


this card is given on pg. 2-2b in Section 2.1.2. 
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3.3 Catalogued Procedures 


Introduction 


Jobs submitted for processing may be considerably simplified through 

the use of catalogued procedures. Frequently used job control state- 
ment sequences are prepared and placed in a library called a procedure 
library, SYS1.PROCLIB. Each catalogued procedure placed in this system 
library becomes a member of that library and so has a member name and 
possibly one or more alias names. A catalogued procedure can be re- 
trieved by using its member name or one of its alias names in the operand 
field of an EXEC statement, rather than naming a program. The entire 
catalogued procedure is substituted in place of the EXEC statement that 


named it. 


Following is a summary of the catalogued procedures in the Campus Facility 


System by name and function. 


Catalogued Procedures for the RTRAN, PL/1 and ASSEMBLER Processors 


Compile only, with 
object deck punched 


Compile and link 
edit 


Compile, link edit 
and execute 


LKED 


Link edit and 
execute 
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A brief description of each of the above catalogued procedures follows. 
Member names and alias names, processor and linkage editor options, and 
procedure stepnames are given. The catalogued options listed with each 
procedure are those which differ from the standard options defined for 
each processor. A brief description of the standard (or default) options 
is given at the beginning of the sections for each processor. (A descrip- 
tion of the linkage editor options indicated in the LKED steps can be 
found in section 3.3.6.) If no specific reference is made to a particular 
option in a catalogued procedure, the standard (or default) option applies 
for that procedure. The user must not override the IAD option under any 
circumstances when using a catalogued procedure which contains a linkage 


editor step. 


If you override the catalogued procedure with a PARM list of your own, 
the new PARM list completely replaces the one in the catalogued procedure. 
Unspecified parameters are given the standard (or default) option. For 
example, if you override the catalogued procedure for FORTHCIG with a 
PARM list specifying DECK (i.e., //AEXECAFMRTHCIG,PARM. FORT='DECK'), then 
the catalogued option for that procedure, which is MAP, will be defaulted 
to the standard option, which is N@MAP. Therefore, if you want to keep 
the catalogued options and you use a PARM list you must repeat the cata- 
logued options in the PARM list. 

(i.e., // A EXEC A FORTHCIG,PARM. RORT= 'DECK,MAP' ) 


Copies of the current Catalogued Procedure Library listing are located 
in the Consulting Office and in the Study Room adjacent to the Dispatch 
Lobby in Pine Hall. Users are encouraged to refer to those listings 
whenever questions arise relating to the contents of a catalogued pro- 
cedure. (For those who may wish to have their own copy of the PROCLIB 


listing, a deck set up is given in Section 3.4, 'Utilities'. ) 
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3.3.1 FORTRAN H Catalogued Procedures 


The standard (or default) options which have been generated for the 
FORTRAN H-level compiler are: 


PPT=00 
NAME=MAIN 
LINECNT=57 
NOLIST 
EBCDIC 
SOURCE 
NODECK 
NOMAP 


LOAD 


NOLD 


NOEDIT 


No optimization of the object code produced by the 
compiler. 

Name assigned to the main program module by the com- 
piler. 

Number of lines per page for a source listing. 

Object code produced by the compiler is not printed. 
Indicates that the source deck is punched in 

EBCD (029) code. 

Source code is printed. 

No object deck is punched for the compiled program. 

No tables are printed of names and labels, neither 

those appearing in the source deck nor the compiler- 
generated ones. 

An object module is generated by the compiler which 

may be used as input to the linkage editor. ‘ 

The object code generated by the compiler does not 
contain an identifier for the compiler-assigned internal 
statement number associated with each function reference 
or CALL statement. 


No structured listing of the source code is printed. 


The stepnames are the same throughout all the FORTRAN H catalogued 


procedures. 


stepname step function 

FORT compilation step 
LKED - linkage editor step 
Gg execution step 


The FORTRAN Subroutine Library, SYS1.FORTLIB, and the SCC Extrinsic 
Library, SYS2.XTRINSIC, have been defined in the FPRTHCL, FSRTHCIG, and 


FORTHIG procedures as automatic call libraries. The libraries will be 


searched in an attempt to resolve any unresolved symbols. 
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Compile only 


FORTHC Member name 
FINH Alias name 


Purpose: A one-step procedure (FORT) to compile FORTRAN source code 


for diagnostic messages for source code debugging. 


Catalogued options: 
FORT step MAP 


Compile and link edit 


FORTHCL Member name 
FINHLINK Alias name 


Purpose: A two-step procedure (F~RT,LKED) to compile source code 
and link edit the object modules generated by the com- 


piler. 


Catalogued options: 
FORT step MAP 
LKED step LET, LIST ,MAP 


Compile, link edit, and execute 


FORTHCLG Member name 
FORTRAN Alias name 


Purpose: A three-step procedure (FORT,LKED,Gf) to compile FSRTRAN 
source code, link edit the object modules generated by 


the compiler, and execute the resulting load module. 


Catalogued options: 
FORT step MAP 
LKED step LET, LIST ,MAP 


Link edit and execute 


FORTHIG Member name 
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Purpose: A two-step procedure (LKED,G®) to link edit previously 


generated modules and execute the resulting load module. 
Catalogued options: 


LKED step LET, LIST ,MAP 
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3.3.2 FORTRAN G cote Procedures 


The standard options which have been generated for the FORTRAN G- payer. 
compiler are identical to those for the FORTRAN H-level compiler with 
the exception that the OPT, ID, and EDIT options are not available in 
FORTRAN G. 


The stepnames are the same throughout all the FORTRAN G. catalogued 


procedures. 


stepnames step function 


FORT compilation step 
LKED linkage editor step 
et) execution step 


The FORTRAN Subroutine Library, SYS1.FORTLIB, and the SCC Extrinsic 
Library, SYSQ.XTRINSIC, have been defined in the FPRIGCL, FORTGCLG, 
and FORIGIG procedures as automatic call libraries. The libraries 


will be searched in an attempt to resolve any unresolved symbols. 


1. Compile only 
FORTGC Member name 
FING Alias name 


Purpose: A one-step'procedure (FORT) to compile FORTRAN source. 


code for diagnostic. messages for source code, debugging. 
There are no catalogued options for this procedure. 
2. Compile and link edit 
FORTGCL Member name 
FINGLINK Alias name 


Purpose: A two-step procedure (MpRT, LKED) to compile FORTRAN 
. source code and link edit the object. nodules generated 


by the compiler. 
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Catalogued: options: 


LKED step LET, LIST MAP 
3» Compile, link edit, and execute 
FORTGCLG Member name 
FINGGO Alias name 


Purpose: A three-step procedure (FORT, LKED,GO) to compile FORTRAN 
source code, link edit the object modules generated by 


the compiler, and execute the resulting load module. 
Catalogued options: 
. LKED step LIST, LET ,MAP 
4, Link edit and execute 
FORTCLG Member name 


Purpose: A two-step procedure (LKED,G®) to link edit previously 
generated object modules and to execute the resulting 


load module. 
Catalogued options: 


LKED step LIST, LET ,MAP 
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3.3.3 Assembler Catalogued Procedures 


The standard (or default) options which have been generated for the 


Assembler are: 


NOTPAD No object module is generated by the compiler 

DECK An object deck is punched for the compiled 
program 

LIST Assembly code is printed 

NOTEST Source symbol table is not added to the 
object module 

XREF A cross-reference table of symbols is printed 

LINECNT=56 Number of lines per page for the assembly 
listing 

NORENT No checking is done by the assembler for 
possible coding violations of program re- 
enterability 


The stepnames are the same throughout all Assembler catalogued procedures. 


stepname step function 
ASM assembly step 
LKED linkage editor step 
Gg execution step 


The FORTRAN Subroutine Library, SYS1. PORTLIB, and the SCC Extrinsic 
Library, SYS2.XTRINSIC, have been defined in the ASMFCL and ASMFCIG 


procedures as automatic call libraries. The libraries will be searched 


in an attempt to resolve any unresolved symbols. 


1. Assemble only 


ASMFC Member name 
ASM Alias name 


Purpose: A one-step procedure (ASM) to assemble Assembler Language 


code for diagnostic messages for source code debugging. 


Catalogued options: 
ASM step TPAD ,NODECK 
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2. Assemble and link edit 


ASMFCL Member name 
ASMLINK Alias name 


Purpose: A two-step procedure (ASM,LKED) to assemble Assembler 
Language source code and link edit the object module 


generated by the assembler. 


Catalogued options: 


ASM step LOAD ,NODECK 
LKED step LIST ,MAP 


36 Assemble, link edit, and execute 


ASMFCIG Member name 
ASMGO Alias name 


Purpose: A three-step procedure (ASM,LKED,G6) to assemble Assembler 
Language source code, link edit the object modules gener- 


ated by the assembler, and execute the resulting load 
module. 


Catalogued options: 


ASM step TPAD ,NODECK 
LKED step LET, LIST,MAP 
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3.3.4 PL/I Catalogued Procedures 


The standard (or default) options which have been generated for the 


PL/1 compiler are: 


EBCDIC 
CHAR60O 


NOMACRG 
SPURCE2 
COMP 


SOURCE 
NOATR 


NOXREF 


SORMGIN=( 002,072) 
NOEXTREF 


NOLIST 


LMAD 


NODECK 
FLAGW 


NOSTMT 


SIZE=413696 


LINECNT=057 
OPT=00 


Indicates that the source deck is punched in 
EBCD (029) code 


Character set used by source code -- 60 
character set 


The compile-time processor is bypassed 
Input to the compile-time processor is printed 


Compile-time processing is followed by 
compilation 


Source code is printed 


No listing of the attributes of identifiers 
is provided 

No listing of cross-references to identifiers 
is provided . 

Margins set for scanning source statements 


No listing of the external symbol dictionary 
is provided 


Object code produced by the compiler is not 
printed 


An object module is generated by the compiler 
which may be used as input to the linkage 
editor 


No object deck is punched for the compiled 
progran 


Level of diagnostic messages printed; FLAGW 
indicates all levels 


Diagnostic messages during execution include 
only hexadecimal offsets relative to the. entry 
points -- statement numbers from the source 
program are not included 


The amount of main storage allocated to the 
compiler 


Number of lines per page for a source listing 


No optimization of the object code produced 
by the compiler 
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The stepnames are the same throughout most of the PL/1 catalogued 


procedures: a 
stepname step function 
PLIL compilation step 
LKED linkage editor step 
Gg execution step 


Note: The one exception to the above is the stepname for the 


catalogued procedure PLIDFC: 


stepname step function 
PLID compilation step 


The PL/1 Subroutine Library, SYS1.PLILIB has been defined in the 
PLILFCL, PLILFCLG and PLILFIG procedures as the only automatic call 
library. The library will be searched in an attempt to resolve any 


unresolved symbols. 


dee Compile only 
PLILFC Member name 


Purpose: A one-step procedure (PLIL) to compile PL/1 source code 
for diagnostic messages for source code debugging. 


Catalogued options: 
PLIL step IGAD ,NODECK 


2. Compile only, object deck punched 


PLIDFC Member name 


Purpose: A one-step procedure (PLID) to compile PL/1 source code 
and get an object deck punched. 


Catalogued options: 
PLID step DECK, NOLPAD 
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3. Compile and link edit 


PLILFCL Member name 


Purpose: A two-step procedure (PLIL,LKED) to compile PL/1 source 
code and link edit the object module generated by the 


compiler. 


Catalogued options: 
PLIL step LPAD ,NODECK 
LKED step LIST, LET ,MAP 


h, Compile, link edit, and execute 


PLILFCIG Member name 


Purpose: A three-step procedure (PLIL,LKED,G£) to compile PL/1 
source code, link edit the object modules generated by 
the compiler, and execute the resulting load module. 


Catalogued options: 
PL1L step LPAD ,NODECK 
LKED step LIST, LET ,MAP 


5. Link edit and execute 
PLILFIG Member name 


Purpose: A two-step procedure (LKED,G®) to link edit previously 
generated object modules and execute the resulting load 


module, 


Catalogued options: 
LKED step LIST, LET ,MAP 
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3.3.5 Miscellaneous Catalogued Procedures 


l. 


Link edit only 


LKED Member name 
LINK Alias name 


Purpose: A one-step procedure (LKED) to link edit object modules 
generated previously by the assembler or any compiler. 


Catalogued options: 
LKED step LIST, LET ,MAP 


The FORTRAN Subroutine Library, SYS1.FORTLIB, the PL/1 Subroutine 
Library, SYS1.PLILIB, and the SCC Extrinsic Library, SYS2.XTRINSIC, 
have been defined in this procedure as automatic call Libraries. 
The libraries will be searched in an attempt to resolve any 


unresolved symbols. 


Link edit and execute 
LKEDG Member name 


Purpose: A two-step procedure (LKED,G£) to link edit object modules 
(card input only) generated previously by the assembler 


or any compiler and execute the resulting load module. 


Catalogued options: 
LKED step LIST, LET ,MAP 


The FORTRAN Subroutine Library, SYS1. FORTLIB, the PL/1 Subroutine 
Library, SYS1.PLILIB, and the SCC Extrinsic Library, SYS2.XTRINSIC, 
have been defined in this procedure as automatic call libraries. 
The libraries will be searched in an attempt to resolve any un~ 


resolved symbols, 


Dnp0 


3.3.6 Notes 


1. The job control statements which are catalogued have been assigned 


sequence numbers. The sequence numbers have the following format: 


00000000 (identifies the first control statement in the 
catalogued procedure) with an increment of 100 added to each 
subsequent control statement in the same procedure. If the 
user supplies the MSGLEVEI=1 parameter in his JOB statement, 
the catalogued JCL will be listed with the sequence numbers 
so that the catalogued JCL is easily identified. 


2. The linkage editor options for each catalogued procedure have been 
listed where applicable. The following is a list of the options 
used and an explanation of each one. 

LET Informs the linkage editor to mark the load module 


executable even though error conditions, which could 
cause execution to fail, have been detected. 


LIST Indicates that linkage editor control statements are 
listed in card-image format in the diagnostic output 
data set specified by the SYSPRINT DD statement. 


MAP Informs the linkage editor to produce a map. of the 


load module. This map indicates the relative location 
and length of main programs and subprograms. 
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3.4 Utilities 
Information on the utilities for the 360/67 can be found in the refer- 
ence manual IBM Operating System/360 Utilities User's Guide, Form No. 


C20-1661. Copies are available for reference in the study room and the 


Systems Documentation Office. 


The following sections contain useful programs that have been included 


for your convenience. 


5.4.1 Obtaining Source Decks of Programs or Subprograms in the Source 


Library 


This Job Control Language coding may be used to punch source decks of 


any of the programs or subprograms in the Source Library. 


MEMBER A NAME=membername 


PUNCH A TYPORG=PO ,MAXNAME=1 


//SYSIN A DD A * 


//SYSUT2 A DD A UNIT=SYSCP 
//SYSUT1 A DD A DSNAME=SYS2. SRCELIB , DISP=6LD 


//SYSPRINT A DD A SYS@UT=A 


//stepname A EXEC A PGM=IEBPTPCH 
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3.4.2 Obtaining Source Listings of Programs or Subprograms in the Source 
Library j 


This Job Control Language coding may be used to. print a listing of any 


of the programs or subprograms in the Source Library. 


/* 


RECORD FIELD=(80,1 20) 
MEMBER NAME=membername 
PRINT TYPORG=P¢ ,MAXNAME=1,MAXFLDS=1 
//SYSIN DD * = 
//SYSUT2 DD SYSSUT=A_ 


 preaerterreeterene| 


//SYSUT1 DD 


DSNAME=SYS2. SORCELIB , DISP=PID 


//SYSPRINT’ DD SYSOUT=A 


//stepname EXEC PGM=IEBPTPCH 
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3.4.3 Character Conversion 


Users who wish to convert their programs from the 026 character set to 
the corresponding 029 characters may do so with the program CHARCONV. 


// JOB ecard | 

//S@BLIB A DD A DSNAMB=SYS2, PROGLIB,DISP=(SLD,PASS ) 
// & SXEC A PGM=CHARCONV — 

//PTOTFOOL A DD A UNIT=SYSCP 

//¥TO6FOO1 A DD A SYS@UT=A 

//FTOSFOOL A DD A * 


Data cards to be reproduced with the EBCDIC character set 
/* | 


Note:, This conversion will not correctly convert the special. characters 
of the ALGOL Extended Character Set. . 


3.4.4 How to Reproduce a Card Deck 

Users who want to reproduce a deck. without performing character conver- . 
sion should use the program called REPR#. REPRO has all the features. 
of CHARCONV except character conversion. 


// JOB cara . 

//JPBLIB A DD A DSNAME=SYS2, PROGLIB,DISP= (PLD ,PASS) 
//STEP1 A EXEC A PGM=REPRO 

//FICTFOOL A DD A UNIT=SYSCP 

//FTO6FOOL A DD A SYSPUT=A 

//FTOSFOOL A DD.A * 


Data cards to be reproduced 


/* 


Note: When using REPR® OR CHARCONV, it is possible to inhibit the 
punching of cards. This is done by supplying a dummy DD card for 
FTO7FOOL, e.g., : 


//¥TOTFOOL A DD A DUMMY 
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5.4.5 PROCLIB Listing 


The following deck setup can be used to obtain a listing of the Cata- 
logued Procedure Library (PROCLIB). 


// Job Cara 
// & EXEC A LISTPROC 
/* 
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3.5 Using Direct-Access Storage Devises 
3.5.1, Reserved File Volumes Available 
The following 2314 volumes are available for reserved file storage: 
SYSO4 . 
SYS05 
SYSO6 
SYSO7 
sysog 
SYSO9 
SYSl2 
SYS13 
sys) 
SY815 
SYS16 
SYS17 


Users must obtain information regarding the availability of space on a 
particular volume before trying to allocate a new data set on the vol- 
ume. ach morning the VTOC (Volume Table of Contents) Iisting for the 
available volumes is posted on the bulletin board outside Room 184, 

Pine Hall. Users are advised to check the listing and allocate new data 
sets on the volume with the most space available, 


WYLBUR users who do not have access to the VTOC listings may examine 
the file &TQOO.SPACE LRECL=121. In it they will find information con- 
cerning the space available on each of the volumes. . 


Users are cautioned that &T00Q0,SPACE and the VTOG listings may be out oF 
date by the time they go to use the particular volume selected. Prudent 
use of the information, however, should be an. aid in finding space for 
the storage of programs and data run in the batch stream. Failure to 
select a volume with enough space available will result in a wasted 
computer run. 
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3.5.2 Space Allocation for Data gets_on the 2314 Disk 
which must be considered when getting UP data 


There are several factors 


set definitions for direct access files. 


1. 


2. 


Space is used more efficiently if large plocks of data are written, 


rather than gmail blocks. For example, this means that if card 


jmages are stored on disk, many more cards may pe stored per track 
n biocks 


if plocks of uh cards (3920 pytes) are written, rather tha 


of one carde The following DCB attributes would be specified for 


this type of blocking- 


vee (gave, BIXBTZEN3 520; 1RECIR 00) 


A table giving the correlation between physical record size and 


number of records per track (see Introduction to TBM systen/ 360 


pirect Access Storage Devices and Or anization Methods, Form No. 


ca0~1649). indicates thet on the 2514, using sequential acc 
methods , 2 physical records of 4520 pytes may be written on one 


Thus with the above DCB attributes 88 cards may be written 


ent for storing 


ess 


track. 
per track. The only block size which is more effici 
cara images (80 bytes each) on the om1h is 8 plock size of 7120, 
which allows 89 cards per +rack. However » WYLBUR cannot accept 
plocks larger than 3624 bytes, go that we advise the use of the 
4520-byte blocks, in most cases. The plock size should be 4 
multiple of the Logical record Length. 
Tf 2000 cards are to be written, 2000/88 = 22-7 +yacks will be 
required. The following space allocation could be used to create 
a data set for storing the earas on the 2314 disk. 

gpAcE=(TRK, (2542) RISE) 
Space is normally allocated by +racks » since it is easier to find 


free tracks than free aviinders. 2 ON tmenke \ 


(ap evi 4{nAer nantain 
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3-5-3 Creating and Using Private Libraries 


Programs can be stored in ‘load module form on the 2314 Disk Storage 
Device. Users wishing to use this feature should be familiar with the 
section in the Programmer's Guide (For FORTRAN IV (Level H), Form No. 
C28-6602) that discusses private libraries and Partitioned Data Sets 
(PDS). 


Reserved file storage on the 2314 Disk Storage Drive is limited to the 
volumes listed in Section 3.5,1. Every data set stored on the 2314 
must have a valid account number as the first four characters of its 


name. 


The following examples illustrate an easy method for creating and using 
your own private program library: 


// Job Cara 

//STEP1 A EXEC A FORTHCL 

//FORT.SYSIN A DD A * 
Fortran Source Decks 


/* 

//LKED.SYSIM6D A DD A DSNAME=PO31FIRE(MATCH) , DISP=(NEW, KEEP), 
// UNIT= 23.14 , VALUME=SER=SY8(7 , 

// SPACE=(CYL,(10,10,1),RLSE) 


This job will put a program on SYSO7 so that it can be used later. The 
important job control statement in this job is the one that esr 
//LKED. SYSIMOD, 


SYSIMAD (System Load Module) is the DDNAME of the output from the linkage 
editor, and that DD card is in the LKED step of the catalogued procedure 
FPRTHCL. We want to override all of the parameters on that card so we 
supply our own: 


DSNAME=P03 1 FIRE (MATCH ) - The name of our data set is PO31FIRE. 
The output of the linkage editor is 
always a Partitioned Data Set (PDS), 
80 we have to show a member name 
also -- here, it is MATCH. 


DISP= (NEW, KEEP ) - Keep this new data set at the end of 
the job. 
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UNIT=23 14 - This data set goes onto a 2314 Disk 
Storage Device, 

VOLUME=SER=SYS07 ~ The serial number of the disk is 
SYSO7. 


SPACE=(CYL,(10,10,1),RLSE)~ Allocate space for this data set by 
cylinders. Primary allocation is 10 
cylinders, secondary allocation is 
10 cylinders, one-256 byte block is 
needed for the PDS directory, and 
release all unused storage after the 
Gata set is created to avoid being 
charged for it. 


// Job Card 

//3$BLIB A DD A DSNAME=PO31FIRE,DIS Pe(@LD,PASS), * 
i} VPLUME=SER=SYSO7 ; UNIT=23 14 

//STEPL A EXEC A PGM=MATCH 

//FTOGFOOL A DD A SYS~UT=A 

//FTO?FOOL A DD A UNTT&SYSCP 

//¥TO5FOOl A DD A * 


Data for Fortran Program 
/* 
This job will execute the program that was created by the previous job 
shown in this section. In order to execute a program that resides in a 
private library, a DD card is required whose DDNAME is JZBLIB. This 
card must be the second card in the job, There can be only one J@BLIB 
card in a job. The parameters on the JSBLIB card are: 


DSNAME=P03 LFIRE - The name of the private library 
where the program resides, 
DISP=(OLD,PASS ) - This disposition is required, 
VOLUME=SER=SYSOT ~ The serial number of the volume 
that contains the private library. 
UNIT=23 14 - The library resides on a 2314 Disk 


Storage Device, 


Notice how the DSNAME, VOLUME, and UNIT parameters match, exactly, those 
that were used when the library (or PDS) was created. 
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The 3rd card is an EXEC card with stepname STEP1. The operand of this 
card is PGM=MATCH, which points to a member of the PDS PO31FIRE. This 
job step will execute the program named MATCH. MATCH is a FORTRAN 
program, so some FORTRAN DD cards are required. 


//FTO6FOO1 DD SYSOUT=A - if there is any printer output. 
//FTOTFOOl DD UNIT=SYSCP - if there is any punched card output. 


//FTOSFOOL DD * - if there is any card input. 
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3.5.4 Leaving Load Modules in the System 


How to use disk storage to avoid recompilation of checked out programs, 
or to avoid the use of object decks. 


This section ig intended to provide a clear and easy-to-follow set of 
procedures for storing checked out portions of programs on disk in load 
module form. It also illustrates how to create a private library once 

a program and its subroutines are completely checked out and the program 
is ready for production. This saves both re-compile and re-linkedit 
time. 


1. To put the first load module in a data set (and create the data set 
at the same time), the following job control statements should be 
followed. 


// Job Card 
//STEPL A EXEC A FORTHCL,PARM. LKED='NCAL' 
//FORT.SYSIN A DD A * 


Source Deck 


/* 
//LKED.SYSIM6D A DD A DSNAME=annnWHOL,DISP= (NEW, KEEP), 
f] VOLUME=SER=SYSO4,UNIT=2314, * 
// SPACE=(TRK,(2,2,4),RLSE) 
//LKED.SYSIN A DD A * 
NAME PROG1 
/* 


This places the object module, praduced from the preceding FORTRAN 
compilation, in the partitioned data set named annnWHOL. (NOTE: 
Users should remember to use their account numbers and data set 
names, annnWH@L is used in this section for illustrative purposes 
and should not be copied.) The member name of the load module is 


PROG1. A member name can contain up to 8 characters, 
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2. To add subsequent load modules to the data set, the following job 
control statements should be followed, 


// Job Card 
//STEP1 A EXEC A FORTHCL,PARM, LKED='NCAL' 
//PORT.SYSIN A DD A * 
Source Deck 

/* 
//LKED.SYSIMOD A DD A DSNAME=annnWHOL,DISP= (PLD, KEEP ) ,UNIT=2314, * 
ih VOLUMESSER=SYSO4 
//LKED.SYSIN A DD A * 

NAME PR@G2 


/* 


3. To compile FORTRAN programs -and link them to programs previously 
stored in load module form in data set annnWHOL use the following 
JCL statements, 


// Job Cara 

//STEP1 A EXEC A FORTHCIG 

//®ORT.SYSIN A DD A * 
Source Deck(s) 


ri % 
//LKED.DDNAM A DD A DSNAME=annnWHOL,DISP=(fLD, KEEP), * 
i VOLUME=SER=SYSO4 , UNI T= 2314 


//LKED.SYSIN A DD A * 
INCLUDE DDNAM(PRGG1,PR6G2) 
ENTRY MAIN 
/* 
The list enclosed in parentheses in the INCLUDE statement should 


contain the names of all members that the user wishes to be used 
in this run. 


4, When the program is completely checked out, a private library should 
be created. This is a partitioned data set containing a load module 
of the complete program. The JCL needed to create this private. 
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library is illustrated below. 


// Job Card 
//STEP1 A EXEC A LKED 


//LKED.SYSIMAD A DD A DSNAME=annnPRIV, DISP=(NEW, KEEP) ,UNIT=2314, * 
// VPLUME=SER=SYSO4,SPACE=(CYL,(1,1,1) »RLSE) 
//LKED.DDNAME A DD A DSNAME=annnWHZL,DISP=(0LD,KEEP), * 


UNIT=23 14, VOLUME=SER=SYSO}4 
//LKED.SYSIN A DD A * 
INCLUDE DDNAME(PRZG1,PRéG2) 
ENTRY MAIN 
NAME PRVLIB 
4 * 
The list enclosed in parentheses in the INCLUDE Statement should 
contain the names of all members that the user wishes included in 


the final load module. 


5. To use a private library, the following JCL statements should be 
followed. 


//  Jobd.Card 

//S@BLIB A DD A DSNAME=annnPRIV ,DISP=($LD,PASS), * 
// UNIT=23 14, VOLUME=SER=SYSO4 

//STEP1L A EXEC A PGM=PRVLIB 

//FTO6FOOl A DD A SYSPUT=A 

//FTOSFOOL A DD A * 


Data Cards 
/* 
Note that the PGM name on the EXEC card should be the member name 


of the private library. Use of a private library means it is not 


neressary to do a link edit each time a job is run. 


At this point the user has two partitioned data sets (1) annnWHOL which 
contains several members (a maximum of 4 per directory block), each of 
which is a separate load module; and (2) a data set containing a single 
member which can be executed without re-linkediting. 
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6. If a programmer wishes to change a load module (i.e., make a change 
in a program already entered in annnWHSL), this can be done with the 
following JCL statements. 


// Job Card 
//STEP1 A EXEC A FORTHCL,PARM, LKED= 'NCAL! 
//PORT.SYSIN A DD A * 


Source Deck 


/* 
//LKED.SYSLM@D A DD A DSNAME=annnWH6L,DISP=($LD, KEEP), * 
// UNIT=2314 , VOLUME=SER=SYSC7 . 


//LKED.SYSIN A DD A * 
NAME  PROG1(R) 
/* 
A new private library, containing the revised PROGL, can then be 
created as shown below, 


// Job Card 
//STEP1 A EXEC A LKED 


//LKED.SYSIMOD A DD A DSNAME=annnPRIV,DISP=(¢1LD, KEEP), * 
// UNIT=23 14 , VALUME=SER=SYSO4 

//LKED.DDNAME A DD A DSNAMEannnWHOL,DISP= (ALD, KEEP), * 
fa UNTT=23 14, VALUME=SER=SYSO4 


//LKED.SYSIN A DD A * 
INCLUDE DDNAME(PR&G1,PRéG2) 
ENTRY MAIN 
NAME PRVLIB(R) 
/* 
This private library can then be used with the same JCL set up as 
shown in step 5. . 


In all of the above examples, the FORTRAN H compiler is referenced. 
The same procedure may be used with FORTRAN G by tere the FORTRAN G 
eavalogued procedures. 


3-2 


Revised February 1968 


7+ Compressing dead space out of a data set. Replacing a member of a 


partitioned data set with a new member creates dead space in the data 
set. This dead space can be removed by doing a move of the data set. 
There are two alternative ways of doing this. One involves moving 
the data set from one volumne to another with the data set name re-~ 
maining the same. The second involves moving the data set to another 
place on the same volume, in which case the data set name must be 
changed. 
(1) The JCL statements used for moving the data set to a new 
volume are shown below. 
// Job Cara 
//STEPL A EXEC A PGM=IEHMOVE 
//SYSPRINT A.DD A SYS@UT=A 
//OPIDSET A DD A UNIT=2314, VOLUME=SER=SYSO4 ,DISP=SLD 
//NEWSET A DD A UNIT=23 14, VELUME=SER=SYSO7 ,DISP=SLD 
//SYSUTL 4 DD A UNIT=2314, VOLUME=SER-SYS03 ,DISPaSLD 
//SYSIN A DD A * . 
COPY PDS=annnWHOL, Th=23 14=SYSO7 , FROM=23 14aSYSO4. 
fe * 
After such a move, the V@LUME parameter of the DD cards described in 
steps 1-6 above must be changed to reflect the new location of the data 
set. 
(2) The JCL statements needed for moving the data set to a new 


place on the same volume are shown below, 


° 


// Job Card 
//STEP1 A EXEC A PGM=IEHMAVE 
//SYSPRINT A DD A SYS#UT=A 
//PACK A DD A UNIT=23 14, VOLUME=SER=SYSO4 , DISP=SLD 
//SYSUT1 A DD A UNIT=2314, VOLUME=SER=SYS03 , DISP=PLD 
//SYSIN A DD A * 
COPY PDS=annnWHOL, 16=23 d=SYSO4, FROM=23 1u=SYSOk, RENAME=annnWHLE 
/* 
After such a move, the JCL statements described in steps 1-6 must now 
contain the new DSNAME. . 
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3.5.5 Deleting Date Sets 


SYS2.PROGLIB contains a program which will aid the user in deleting 
data sets prior to their expiration date. The restrictions which apply 
to this program are: 

1. Only data sets with valid DSNAMES can be deleted, 


2. Only data sets residing on volumes where reserved files are 
allowed can be deleted. 


3. The format for the data cards used by this program is: 
volume serial number, data set name 
or 
volume serial number, data set name, MEMBER=member name 
Blanks are ignored, so the layout is not critical; however, the 
sequence of the items must be correct. Example: 


// Job Cara 
//JPBLIB A DD A DSNAME=SYS2. PRAGLIB, DISP=(SLD, PASS ) 
//STEP1 A EXEC A ERASE 
//ERASE.SYSIN A DD A * 
SYSO7, annnDATA 
CAMP31, annnDATB 
CAMP31, annnDATA 
CAMP31, annnDATA,MEMBER=SUB1 
CAMP31, annn.A.B.C 
/* : 
This job will execute the catalogued procedure "ERASE", "ERASE", a 
collection of job control statements, executes a program from SYS2,PR¢GLIB. 
This generates the need for the JOBLIB card. 


This job will erase: 


annnDATA in SYSO7 

annnDATB — in CAMP31 
annnDATA in CAMP31 
annn.A,B.C in CAMP31 


Member SUB1 from PDS annnDATA in CAMP31 


Reminder! The J@BLIB card must be the second card in the job, and must 
look exactly like the one shown above. 


5-4 


Added May 1968 


3.6 WYLBUR 


WYLBUR is a text editor designed to operate in either an OS or HASP 
environment in order to provide users at 2741 terminals a comprehensive 
text editing facility with prompt response, while otherwise allowing the 


computer to proceed with processing of the normal batch job stream. 


WYLBUR allows the user to. change the contents of a line without retyping 
all of it, to insert, delete or replace lines, to copy and move lines, 
to renumber lines, and to list lines. In addition, the user may retrieve 
external data sets in order to work upon them and save data sets which 
have been constructed. The user may also insert the data set into the 


monitor's input stream for processing as a batch job. 


3.6.1 Obtaining a Terminal 


Requests for a remote terminal device must be made on an Interdepartmental 
Request form number SU-13. Non-Stanford organizations will use a purchase 


order. This form should contain the following information: 


University account number to be charged. 
b. Period for which service is to be provided, 


ec. Location point for installation of terminal device. (Must 
indicate building and room number. ) 


a. Person(s) in charge of terminal and their telephone number(s). 
e. Number of terminals required. 
f. Estimated number of users. 


g. Existing account numbers or application for new account numbers 
(see Section 3.6.2) to be authorized use of the terminal, and 
& keyword for each account number. 
Interdepartmental Request forms require the signature of a person author- 
ized to commit funds. The completed form should be sent to R. Montgomery, 
Pine Hall. 


Terminals are rented by the Stanford Computation Center, Campus Facility, 
from IBM and re~billed to the user who requests installation. The cost 


to the owner of a campus installation, exclusive of use, is as follows: 
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Line Concentrator System 


Month Installation Cos 
——~  |§ Installation Cost 


IBM 2741 Terminal $ 8h, kox $ 60.00 
103A2 Data Set 30.00 60.00 
Leased Line (average) 4.00 10.00 

Total $118.42 $130.00 


For off-campus installations where business lines are used, the cost is: 


Telephone Business Line System 
Monthly Installation Cost 


IE 2741 Terminal $ 8h. how $ 60.00 
103A2 Data Set 30.00 60, 00 
Business Line 11.05 15.00 

Total $125.47 $135.00 


*As of July l, 1968, monthly rental for 2741 terminals will be increased 
by $13.44/month. After this time the monthly charge for terminal ren- 
tal will be $97.46/month. 


(NOTE: Terminal rent and installation costs are incremental to the 
SCC Campus Facility approved budget. Therefore, Provost's Funds which 
are already part of the Campus Facility Budget cannot be used to cover 


these costs, ) 


Assuming the availability of IBM 2741 terminals, normal lead time for 
installation will be three weeks after receipt of an Interdepartmental 
Request form. Thirty days prior written notice to IBM from the Campus 
Facility is required to terminate the rent of a 2741; therefore, rent 
will be charged to the user 40-full days after the Campus Facility re- 
ceives written notice to terminate. Proration of monthly charges will 
be based on a 30-day month. 


3.6.2 Account Numbers for Terminals 
eee nearer kcal 


Only account numbers authorized for use on WYLBUR by terminal renters 
will be accepted by the WYLBUR system, 
The Computation Center Accounting Office (Room 164, Polya Hall) provides 
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account numbers based on an "Application for Services" form prepared by 
the user. (General information on an account number application and an 
example of the form used can be found in Section 2.1.1, pg. 2-1.) Who- 
ever pays rent on a terminal must designate which account numbers are 
authorized to use terminal service. To establish new account numbers 
for use on terminals, the standard Application for Services form should 
be used by the terminal renter. If an existing number is to be used on 
a terminal, the terminal renter must notify the Computation Center Ac- 
counting Office in writing (in the Interdepartmental Request for the 
terminal or by memo). Normally, account numbers received or assigned 
by the Accounting Office between Monday morning and Friday at 3:00 p.m. 
will be entered into the System by 8:00 p.m. the same day. Account num- 
bers received or assigned between Friday at 3:00 p.m. and Monday morning 
will be available for use by 8:00 p-m. Monday. Cancellation of author- 


ized account numbers for terminals will be handled on the same schedule. 


When an account number is authorized for terminal use, it is associated 
with a system key. While authorized account numbers can be used from 
any terminal, this system will not accept simultaneous use of more than 
one account number associated with any one system key. For example, 
account numbers ZOOO, ZOO1, and Z002 are associated with system key H12. 
Only one of these three account numbers can be used from any WYLBUR ter- 
minal at one time, However, it is possible for one account number to be 


associated with more than one system key. 


3.6.3 Current Rate Structure for WYLBUR Services 
tre for WiLDUR Services 


A composite rate has been established to cover access duration and CPU 
editing time on the WYLBUR System. This charge is applied as a rate per 
terminal hour. Thus, charges are based upon the total time between 
"sign-on" and "log-off". Access duration and editing charges will be 
levied against the account number used to sign onto the System. The 


current rate is $4/terminal hour. 


Batch jobs entered via terminals will result in processor and related 
charges for batch service in a manner identical to batch charges for 


jobs not entered from terminals. 
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The complete rate schedule for Campus Facility services is on page 2-2. 


3.6.4 Security Measures for Account Protection 


Users who wish to protect their accounts against use by unauthorized 
persons may accomplish this through use of a KEYWORD. At the time an 
account is established, the user may specify the 3-character keyword he 
desires. Each time he signs on from a terminal, the account number and 
the keyword will be checked for validity. If non-matching keyword and 
charge number are specified, the user will not be granted access to the 
system. While use of keyword is not mandatory, it is strongly encour- 
aged. 


If a user wishes to change his keyword, he may submit a request to the 
Accounting Office specifying the account number, the current keyword, 
and the new keyword. This request should be signed by the holder of 
the account. Keyword changes are processed by the Accounting Office on 
the same schedule specified in Section 3.6.2 for processing of account 


numbers. 


3.6.5 Documentation 


A complete description of the WYLBUR text editor -- Appendix E of the 
Users Manual -- may be obtained from the Systems Documentation Office, 
Room 185, Pine Hall. 


Also available to WYLBUR users is the file &TOOO.NEWS (edit format). 

This file contains information on new WYLBUR features and changes that 
may not have been incorporated in the current WYLBUR manual. The first 
part of this file contains an index to its contents and the entry date 


for each item put into the file. 


3.6.6 Notes 
3.6.6.1 Plot Instructions for WYLBUR Users 


The SHOW OPERATOR command is used at the remote terminal to communicate 
tape mounting for plots and necessary plot instructions to the computer 


operator. Remember that any job requiring a tape must have an S in the 
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appropriate field of the job card (see pg. 3-4 for job card information), 
The following information is required. 


(1) (2) (3) (4) (5) (6) (7) 


PLOT, name, account no., paper, pen, ink, special instructions 


Item (1) enter the word PLOT; item (2) enter your name; item (3) enter 
your account number. Items (4)-(7) are optional. If omitted, the de-~ 
fault specifications indicated for items (4) and (5) in the following 
table will be used. 


ITEM ENTER SPECIFICATION COLORS 
Width Description 
(4) paper 00 default 10", plain white 
o1(*) 10", graph, 10 divisions/inch *red, blue, 
olive-brown 
02(*) 10", graph, 20 divisions/inch red, blue 
300 30", plain white 
301 30", graph, 10 divisions/ineh olive-brown 
(5) pen 3 .3mm, fine 
) default .5mm, medium 
«6 .6mm, broad 
(6) ink red 
blue 
black (default) 
green 
Example: 


COMMAND? show operator 'PLOT, J. Smith, A000, Ol(blue), red! 


The operator will mount a plot tape. Output will be plotted on 10" blue 
graph paper (10 divisions/inch) with a .5 (medium) pen in red ink. 


3.6.6.3 Tape Handling Instructions for WYLBUR Users 


To indicate a tape mount (other than for plotting) to the computer op- 
erator use the SHOW OPERATOR command ana enter the following information. 
Remember that.any job requiring tape must have an S in the appropriate 


field of the job card (see pg. 3-4 for job card information). 
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(1) (2) (3) (4) (5) (6) —s (7) (8) 


write special 


enable’ channels, drive, instructions 


TAPE, name, account no., reel, 


_ For item (1) enter the word TAPE; item (2) your name; item (3) your 
account number; items (4)-(7) are explained in the table below. 


ITEM ENTER 
(4) reel enter reel I.D. if a reserved tape or private tape 


SCRATCH operator will mount a scratch tape 


RESERVE operator will mount a scratch tape and 
reserve it to the name and account as 


shown 
(5) write enable WR operator will write enable the reel; if 
no entry, the tape will be file protected 
(6) channels 7 tape will be mounted on a 7 channel tape 
drive 
9 tape will be mounted on a 9 channel tape 
drive 
(7) drive enter physical address of drive if required 


Example: 
COMMAND? show operator 'TAPE, J. Smith, A000, SCCO0O, 9! 


The operator will mount tape SCCOOO on a 9-track drive. The tape will 
be file protected. 


3.6.6.3 TOOO.JCL 


TO0O.JCL is intended to help WYLBUR users with Job Control Language. In 
order to get such information as the FORTRAN compile listing, the LKED 
map, and the execution output into data sets that can be accessed by 
WYLBUR (instead of the usual printed output from the printer at the 
Campus Facility), it is necessary to override the SYSPRINT and SYSéUT 
definitions for the COMPILE, LKED, and GA steps, respectively. T000.JCL 
provides the necessary JCL for doing this plus instructions for copying 
statements from TOQOO.JCL to a terminal work area, The file now contains 
Job Control Language for the following applications: 
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1. Saving the following types of output in a data set on the 2314 
disk, to be referenced later from a terminal: 


FORTRAN IV Level H compiler listing, 

Linkage map and error diagnostics, 

FORTRAN IV Level H program execution listing, 
WATFOR compiler and program execution listing, 
Assembler Level F listing, 

Assembler Level F execution listing, 

PL/1 compiler listing, 

BMD program execution listing. 


2. Reading a card deck in from a batch job and saving it on a 
data set on the disk for future reference from WYLBUR. 


3. Printing or punching data sets created by WYLBUR. 


4. JCL for SORT, with input from a data set stored in card format 
on the disk and output to the disk. 


5. %JCL for transferring a source copy of library programs from 
SYS2.SP@RCELIB into a data set for modification and use from 
WYLBUR o 
The first part of TO0O00.JCL contains a list of the various JCL applica- 
tions available. Users should list the file offline before using, as 


the line numbers for the various DD statements may have been changed. 


3.6.6.4 WYLBUR Files Blocked 


WYLBUR files are saved in blocked format. Files which are saved in card 
format will be blocked 44 records/block; in print format, 26 records/block. 
In order to save files in unblocked format, the user must specify a 


blocking factor of 1 in his save command: 
SAVE dsname CARD (1) 


If files are saved with the format specified by the 'LRECI=' option, 


each block will contain one record. 


When retrieving files that have been saved by WYLBUR, you should specify 
the following parameters in the data control block field of the DD card: 


Da2d 


Added May 1968 


WYLBUR command used DCB field 

SAVE dsname CARD DCB= ( RECFM= FB, LRECL=80, BLKSIZE=3520) 
SAVE dsname PRINT DCB= ( RECFM=FB, LRECI=133 , BLKSIZE=3458) 
SAVE dsname LRECL=nnn DCB=( RECFM=F, LRECLennn, BLKSIZE=nnn) 


The blocking factors used by WYLBUR allow storage of 88 cards/track, in 
card format, and 52 lines/track in print format. Since this is very 
efficient use of space on the 2314 disk, we suggest that WYLBUR users 
use the same blocking factors when creating files to be referenced 
through WYLBUR. For example, to create an output file from FORTRAN H 
in print format, with 300 lines of output expected, you would use the 
following DD statement: 


//Gh.FTO6FOOL DD SYS#UT=,DISP=(NEW, KEEP) ,UNIT=2314, x 
// VOLUMESSER=SYSnn, nd 
// DCB=(RECFM=FB, LRECL=133 ,BLKSIZE=3458), x 
// DSNAMB=Annn. DSNAME , SPACE=(TRK,(6,2),RISE) 


Note that 6 tracks are allocated in the SPACE parameter. This alloca- 
tion is enough for 312 lines of output, The secondary allocation of 2 
tracks will allow space for up to 780 more lines. 


3.6.6.5 &T000.SPACE 


WYLBUR users needing to know the amount of space available on various 
volumes may examine &TO00.SPACE LRECIe121. In it they will find infor- 
mation concerning the space available on each of the volumes where the 
storage of data sets is permitted. 


The program which creates this file of information is run at least once 
a day and is generally as current as the VIOC listing posted daily out- 
side of Room 184, Pine Hall. (See page 3-34. ) 


Users are cautioned that this information may be out of date by the time 
they go to use the particular volume selected. Prudent use of the in- 
formation, however, should be an aid in finding space for the storage of 
programs and data run in the batch stream. 
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4. LANGUAGE PROCESSORS 
Ke FORTRAN 
hod. Description of the Language 


FORTRAN is one of the most commonly used programming languages. It is 
especially useful in writing programs for scientific and engineering 
applications that involve mathematical computations. FORTRAN is usually 
available in some form at even the smallest computer installations, and 
a variety of library and applications programs are available for easy 
use. In fact, the development of FORTRAN is so widespread that the 
American Standards Association has defined a basic FORTRAN language 

(ASA FORTRAN) which specifies the fundamental elements of the language. 


FORTRAN IV for the Operating System 360 is compatible with and encom- 
passes ASA FORTRAN, including its mathematical subroutine provisions. 
It is described in the IBM System/360 FORTRAN IV Language Manual (Form 
No. C28-6515) and is supplemented by the mathematical subroutines in 
IBM's Scientific Subroutine Package (described in the form H20-0205). 
The SSP contains a number of commonly used routines for data screening, 
regression, analysis of variance, non-parametric statistics, matrix 
operations, integration and differentiations, etc. 


In addition, the Stanford Extrinsic Program Library and the Applications 
Program Library have been locally developed to provide additional facil- 
ities to the FORTRAN user. Programs for plotting, numerical integration, 
linear system solution, matrix inversion, linear least squares solution, 
the UCLA Bio-Medical Computer Programs (BMD's) and the Electronic Circuit 
Analysis Program (ECAP) are among those included in these libraries. 


The major library development and consulting effort of the Campus 
Facility is directed toward the support of FORTRAN IV (levels G and H). 


4.1.2 Documentation 


Ll. 


IBM System/360 FORTRAN IV Language, Form No. C28~-6515. 


This publication describes the IBM System/360 FORTRAN IV Language 
for the IBM System/360 Operating System. It provides a quick 
definition and syntactical reference to the various elements of 


the language. 


IBM System/360 Operating System FORTRAN IV (G) Programmer's Guide, 


Form No. (28-6639. 


This publication describes how to compile, link edit, and execute 
a program written in FORTRAN IV using the G-level compiler. It 
gives details on the implementation of the FORTRAN IV lenguage and 
how the programmer communicates with the system to execute his 
job. 


IBM System/360 Operating System FORTRAN IV (H) Programmer's Guide, 


Form No. C28-6602. 


This publication describes how to compile, link edit, and execute 
a program written in FORTRAN IV using the H-level compiler. It 
gives details on the implementation of the FORTRAN IV language and 
how the programmer communicates with the system to execute his 
job. 


IBM System/360 Operating System FORTRAN IV Library Subprograms, 


Form No, C28-6596. 


This publication describes the library subprograms supplied with 
FORTRAN IV and provides the information necessary to use the 

library subprograms in either a FORTRAN IV or an assembler language 
program. In addition, the publication contains algorithms, accuracy 
statistics and timing estimates, descriptions of error and inter- 


ruption procedures, storage estimates, and sample storage printouts. 


WL. 


Note 1: 


Note 2: 


Note 3: 


Sample Deck Set-ups 


All of the control cards (i.e., // and /*) must be punched 
starting in column 1. Blanks, at least one, are required 
where the symbol A appears. Blanks must not appear in 
other fields on the card. 


The "“stepname" information on the EXEC card can be used at 

the option of the programmer. If it is used, the programmer 
may choose any stepname that he wishes -- however, it cannot 
be longer than 8 characters. The first character of this name 
must immediately follow the slash -- there can be no blanks. 
If the stepname is omitted, there must be at least 1 blank 
after the second slash before the word EXEC. 


The deck set-ups illustrated can also be used with FORTRAN G. 
To do so, change the catalogued procedure in the EXEC state- 
ment to the corresponding form for FORTRAN G (i.e., change 
FORTHC to FORTGC, etc.) 


1. Deck set-up for a compile only job: 


<J@B CARD> 


Source cards 


//FORT.SYSIN A DD A * 


//stepname A EXEC A FORTHC 


3 


To obtain an object deck from the above, the execute card should be 
changéd as follows: //stepname 4 EXEC A FORTHC,PARM.FPRT='"DECK' 


a3 


2. To link and go previously compiled decks the following deck set-up 
should be used: -~ 


Omit if 
no data 
cards 


Object cards 


//LKED.SYSIN A DD A * 


//stepname A EXEC A FORTHLG 


<J@B CARD> 


yh 


3. To compile, link and go the following deck set-up should be used; 


Omit if 
no data 
cards 


Omit if no 
object 
cards 


//stepname A EXEC A FORTHCLG 
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4.1.4 Helpful Hints 


1. There have been several significant additions to the language of 


which the user should be aware. Some. of these. are: 


o Use of quotes to enclose a Hollerith ‘constant (BCD string) 
instead of requiring a character count. (The count may still 
be used. ) 


o The IMPLICIT statement used to define and type variables 


according to their first character. 


o The Explicit type statements used to type variables and, 


optionally, to assign values to them. 
o Two new format codes, G and T. 
o Addition of double precision complex variables and constants. 
o Allowing mixed mode expressions. 


o The READ statement has been extended to include transfers on 


end-of-data and/or redundancy error. 


2. In converting programs or writing programs that are compatible with 
both versions of FORTRAN IV (7090 and 360 versions), the sa 


areas of difficulty are: 


o Any use of the format specification A6 must be checked... The 
corresponding I/O list item must be either redefined as a 
REAL with length 8 (double precision variables are now. termed 
REAL*8) or the specification must be changed to A’ and the 
I/O list expanded correspondingly (which may also necessitate 
changing DIMENSION statements). 


o All COMMON and/or EQUIVALENCE statements must be checked to 
see that the variables are listed so that they observe the 


hardware boundaries. 


o Octal constants must be replaced by hexadecimal] constants and 


the use of AND or OR functions must be changed to be consis~ 


4-6 


Revised May 1968 


tent with the new word length and character set. 
o Implied DO's must be removed from DATA statements. 


o If 7 significant figures are not sufficient, programs must 
be converted to double precision. Then constants with less 
than eight significant digits must be rewritten with a D 


exponent. 


o Binary tapes written by 7090 FORTRAN cannot be read directly 
by 360 FORTRAN. (Binary tape conversion routines are being 
provided. These are discussed in a document prepared by the 
SLAC Computing Facility of the Computation Center. This 
document, "7090/7094 to 0S/360 Magnetic Tape Conversion," is 
available from the Systems Documentation Office, Room 185, 
Pine Hall, Ext. 4877.) 


o Blank fields read with I, HE, F, or D format are no longer 


converted to -O. They are converted to +0. 


o Shifts effected by multiplication or division by 2 must be 
checked to assure that: 

a. The shift is no more than 32 positions. 

b. The shift is compatible with the new representation for 
negative integers. (Negative integers are stored as the 
two's complement of their absolute value with the sign 
position negative. ) 

c. If BCD characters are being manipulated, the number of 
bits/character is 8 rather than 6. 


o All MAP subprograms must be rewritten. 

o End-of-file trap routines are no longer necessary. 

Users who wish to convert their own programs from the 026 character 
set to the corresponding 029 characters may do so with the program 
CHARCONV. A sample set-up of this program is in Section 3.4, 


"Utilities". (Note: This conversion will not correctly convert 


the special characters of the ALGOL Extended Character Set.) 
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Use the FORTRAN G compiler for debugging during program development 
and for short, one-shot programs, Once a program has reached the 
production stage, use FORTRAN H with #PT=2. The reason for this is 
that FORTRAN G is a small fast compiler, but it produces a relative- 
ly slow object code. On the other hand, FORTRAN H is a larger but 


slower compiler, though it produces a fast object code. 


When using exponents use X**2 rather than X**2.0 -- in general, use 
<expression> ** < integer> or <expression> ** <integer expression> 
rather than <expression> **«real>. This method will save time and 


accuracy. 


Remember, underflow usually occurs when exponentiating numbers or 
expressions <1. (e.g., .0005%**20). 


Make sure arguments to subroutines, functions, or arithmetic state- 


ment functions are all of correct type and length. 
Never try (by accident or on purpose) to reset a constant: 


CALL ASUB(5) SUBRGUTINE ASUB (Z) 
z=4 
RETURN 
END 
All characters and character handling routines should be written in 


integer variables rather than real. 


From the FORTRAN supplied subprograms, pick the function you mean -~+ 
use either single precision or double precision, and use the right 
form of the argument, etc., (e.g., SIN, for single precision vari- 
ables; DSIN, for double precision variables; the argument in ra- 


dians, etc.) 


On input, decimal points override specified field specifications. 
Otherwise, numbers must be correctly justified. For example: If 
the format specified is F8.% and the number on the date card in 
the first eight columns is 17.0014, then the number of decimal 
places designated by the format statement (3) will be overridden 


and the number will appear as on the data card. However, in the 
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format statement I5, the number must be right justified as embedded 
and trailing blanks are treated as zeros. Integers on input and out- 
put are always right justified. . 


4.2 PL/1 


4.2.1 Description of the Language 


“PL/1 is a multipurpose programming language for use not only by commer- 
cial and scientific programmers but by the real-time programmer and the 
systems programmer as well. PL/1 contains substantially all of the 
capabilities of FORTRAN, ALG@L, and BALGOL with some additional features 


(i.e., list processing capabilities, bit and character string manipulation). 


One of the primary aims in the design of the language was modularity, that 
is, providing different levels of the language for different applications 
and different degrees of complexity. This means that a programmer experi- 
enced in. FORTRAN or ALG@L need not learn all of PL/1, but only a subset of 
it that closely resembles the language he has been using. The subset that 
he learns will provide the programmer with the capability to operate effi- 
ciently in PL/1. 


4.2.2 Documentation 


1. IBM System/360 Operating System PL/1 Language Specifications, 


Form No. Cc28-6571. 


This manual gives a complete description of the PL/1 language, inde- 
pendent of any particular implementation. It contains a very detailed 
explanation of the language, though the wording is often unclear and 
there are few examples given. It is not a manual for inexperienced 


programmers wishing to learn PL/1. 


2. IBM System/360 Operating System PL/1 (F) Programmer's Guide, 


Form No. C28-6594. 


This manual describes the IBM F level implementation of PL/1 and 
gives information on how to use it. It is not a language description. 
It includes: | 
a) Language features not supported in the current (2nd) release 
of PL/1. These features are listed in Appendix H of the 


manual. 
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b) Implementation conventions and restrictions (i.e., limits 
on array bounds, limits on size of an individual statement). 
These are listed in Appendix B. | 

c) A detailed description of the implementation related input/ 
output features ~-- most specifically in the area of Record 
1/0. 

ad) A list of the diagnostic messages the compiler produces and 
other information about compiler output. 

e) Debugging information. 


f) A discussion of cataloged procedures and job control, 


A Guide to PL/1 for FORTRAN Users, Form No. C20~1637. 


This manual gives a good introduction to PL/1 for programmers who 
know FORTRAN. It is not a complete description of the language, but 
it is clearly presented and contains many examples. 


A PL/1 Primer, Form No. C28-6808. 


This is a good manual for novice programmers who wish to learn PL/1 
or for more experienced programmers who want a quick overview of the 
language. It does not contain a complete description of the language. 
The material, though, is well presented an includes numerous examples. 


PL/1 Subset Language Specifications, Form No. c28-6809. 


This is a scaled down version of the Language Specifications manual, 
It describes a subset of PL/1, not a commercial or scientific subset, 
just a subset. Also, the subset described is not related to any 
particular implementation of PL/1. It uses examples sparingly and 

is not an easy manual to read. | 
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4.2.3 


Note l: 


Note 2: 


Sample Deck Setup 


All of the control cards (i.e., // and /*) must be punched 
starting in column 1. Blanks, at least one, are required where 
the symbol A appears. Blanks must not appear in other fields 


on the card. 


The "stepname" information on the EXEC card can be used at the 
option of the programmer. If it is used, the programmer may 
choose any stepname that he wishes -- however, it cannot be 
longer than 8 characters. The first character of this name must 
immediately follow the slash -- there can be no blanks. If the 
stepname is omitted, there must be at least 1 blank after the 
second slash before the word EXEC. — | 


1. Deck setup for a compile only job: 


To obtain an object deck from the above, the execute card should be 
changed as follows: //stepnameAEXECAPLLLFC ,PARM. PL1L='DECK' 
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2. Deck setup for a compile, link edit, and go job (single compilation): 


Omit if no 
data cards 


Source deck 


//PLIL.SYSIN A DD A * 


//stepname A EXEC A PLILFCLG 


<J~B CARD> 


To obtain an object deck from the above, the execute card should: be 
changed as follows: //stepnameAEXECAPLILFCLG, PARM. PLIL='DECK’ 
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3. Deck setup for a compile, link edit, and go job (multiple compilations): 


Omit if no 
data cards 


//stpnamen A EXEC A PLILFCLG 


/ 


Source deck #1 : 


PLLL.SYSIN A DD A * 
stpnamel A EXEC A PLILFC 
<J@B CARD> 
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4. Deck setup for link edit and go job (assuming object decks read from 


the card reader): 


Omit if no 
data cards 


Object decks 


//LKED.SYSIN A DD A * 


//stepname A EXEC A LKEDG 


<J$B CARD> 


DD cards describing data sets to be used in the users GO step should be 
placed in the deck just before the //G@.SYSINADDA* card. 


e5 


Revised May 1968 


4.2.4 Helpful Hints 


The chapterm “Programming Techniques" in the PL/1 (F) Programmer's 
Guide can be most helpful to the PL/l user. It contains the section 
‘Common Errors and Pitfalls' which is an excellent discussion on the 
snags most likely to trip up a new, or not so new, PL/1 programmer. It 
also contains a section entitled ‘Programming for Increased Efficiency’ 


which gives information for improving both compile and execution times. 


4.2.5 Input/Output Capabilities 


There are two types of I/O in PL/1 -- stream and record. In stream 1/0 
a data set is regarded as a continuous stream of characters. In record 
1/0, the data set consists of discrete records, and no conversions occur 


during transmission. 


The devices that may be accessed using stream I/O are: card reader, 
card punch, printer, disk and tape. The devices which may be used 
with record I/0 are disk and tape. 


Stream I/O implies sequential access of data. When record I/O is used, 
data may be accessed sequentially or randomly. For random access, the 


device type must be disk. 


Programmers who plan to use record I/O should read the chapter, "Manag- 
ing Data," in the PL/l Programmer's Guide. It contains information 
essential to the understanding of F level PL/1 record 1/0. A few fea- 
tures of record I/0 have not yet been implemented. These are listed 


in Appendix H of the Programmer's Guide. 


The PL/1 catalog procedures provide DD cards only for the printer, card 
reader (compile and go step), and punch (compile step only). If any 
other data sets are referenced by a program, the user must supply appro- 
priate DD cards in the Gé step of the job. Information on how to make 
DD cards can be found in the PL/1 (F) Programmer's Guide in the chapter 


entitled, "Managing Data", and also in the publication, IBM System/360 
Operating System Job Control Language, Form No. C28-6539. 
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4.3 Assembler Language 


4.3.1 Description of the Language 
The IBM System/360 Operating System Assembler Language is a symbolic 


programming language which permits the programmer to use all machine 


functions as if he were coding machine language. 


The assembler program that processes the language translates symbolic 


instructions intc machine-language instructions, assigns storage 


locations, and performs auxiliary functions necessary to produce an 


executable machine-language program. 


4.3.2 Documentation 


1. 


AD 


IBM System/360 Operating System Assembler Language, Form 
No. C28-6514. 


This publication contains specifications for the Operating System 
Assembler Language. Part I of the manual describes the assembler 
language and Part II describes an extension of the assembler 

language - the macro language - used to define macro-instructions. 


(145 pages) 


IBM System/360 Operating System Assembler (F) Programmer's Guide, 


Form No. C26-3756, 


This publication compliments the IBM System/360 ¢S Assembler 
Language manual. It provides a guide to program assembling, 
linkage editing, executing, interpreting listings, and assembler 
programming considerations. Included in Appendix A of the manual 
is a description of the Assembler Language diagnostic messages. 


(48 pages) 


IBM System/360 Principles of Operation, Form No. A22-6821. 


This publication is the machine reference manual for the IBM 
System/360. It provides a direct, comprehensive description of 
the system structure - of the arithmetic, logical branching, 
status switching, and input/output operations, and of the inter- 
ruption system. It is the only manual that gives a detailed 
description of the various machine instructions. (172 pages) 
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4.3.3 Sample Deck Setups 


Note 1: All of the control cards (i.e., // and /*) must be punched 
starting in column 1. Blanks, at least one, are required where 


the symbol A appears, Blanks must not appear in other fields 
on the card. 


Note 2: The “stepname" information on the EXEC card can be used at the 
option of the programmer. If it is used, the programmer may 
use any stepname that he wishes. The first character of this 
name must immediately follow the slash -- there can be no blanks. 
If the stepname is omitted, there must be at least 1 blank after 
the second slash before the word EXEC. 


1. To assemble only the following deck setup should be used: 


To obtain an object deck from the above, the execute card should be 


changed as follows: //stepnamedEXECAASMFC , PARM, ASM='DECK' 
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2. To link and go previously assembled decks, the following deck setup 
should be used: 


//UKED.SYSIN A DDA * 


//stepname A EXEC A ASMFLG 


<J@B CARD> 
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3. To assemble, link and go the following deck setup should be used: 


Omit if no 
data cards 


Omit 
if no 
object cards 


Source cards 


//ASM.SYSIN A DD A * 
//stepname A EXEC A ASMFCIG 


<J@B CARDD> 
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4.3.4 Helpful Hints 
The Operating System/360 Assembler Language offers a’ greater flexibility 


to the machine-language programmer than was available in earlier large- 
scale assembly systems such as FAP and MAP. This is due to the fact 

that the ps Assembler, unlike most traditional two-pass assemblers, 

makes four logically distinct passes over the source program. The 

third and fourth passes perform the usual two-pass assembly process. 

The first pass consists of macro editing and global dictionary collection, 
and the second pass involves macro expansion and conditional assembly. 
Some of these operations are occasionally included in the first pass 

of a standard assembler, but with considerably less capability than 

is found in the OS Assembler, 


The following examples illustrate some situations often found in the 
use of the Assembler Language. They help to indicate some of the 
features of the Assembler as well as some of the problems involved in 


its use. 


1. When using the CSECT assembler instruction, you may reference 
symbols from a control section other than the one in which 
it is defined. This means that (1) an individual symbol can 
be used only once in an assembly step, and (2) because of 
the base-displacement addressing scheme used in the System/360, 
it apparently may be possible to address a symbol, whereas 
under later relocation by the linkage editor the address will 
be incorrect. This occurs because a USING instruction which 
applies in one control section will apply to code which 
references symbols in that control section from another, 
even though no provision may have been made for loading an 
appropriate base register before the reference. In general, 
the capability of assembling multiple control sections must 
be used with care. This situation is somewhat alleviated 
Since the Assembler does not do multiple assemblies -- all 
cards following the END card are not processed as a new 


assembly. 


2. One feature of the four-pass assembly is that some attributes 
of certain symbols can be used during the conditional assembly 
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pass to determine what quantities are to be generated for 
conventional assembly during the last two passes. The general 
rule is that a symbol whose type, length, integer, and scale 
attributes are defined without using ordinary or variable 
symbols can have those attributes used during conditional 
assembly. A notable exception to this rule is the EQU 
instruction. It might seem that the statement A EQU 5 should 
define the attributes of A. It must be remembered, however, 
that this equivalence does not become operative until the 

last two passes, so that all symbols defined in EQU statements 
are undefined (have type attribute U) during pass two. This 
apparent discrepancy is easily circumvented by the use of a 
variable symbol, as in the statement &A SETA 5. The programmer 
will find that, in many situations where the use of ordinary 
symbols is either cumbersome or forbidden, variable symbols 


provide the necessary capability. 


3. The variety of methods available for testing macro-instruction 
operands (the actual parameters) is quite extensive. Such 
operands may be treated as character strings, symbols, or 
lists of either. Their properties may be tested in a number c* 
ways, such as character comparison, symbol equality, and so 
on, giving considerable flexibility in the design and use 


of macro~instructions. 
4.3.5 Helpful Hints in Other Manuals 


Since one of the major uses of machine language programs will be 
writing special purpose routines to te called from higher-level 

languages, the prospective programmer of such codes should become 
familiar with the appropriate sections of manuals which describe 


linkage conventions in the desired language. A recommended starting 


point is the first part of the publication IBM System/360 Cperating 
System Supervisor and Data Management Services, Form No. C28-66h6. 


The first sections contain a description of linkage conventions 
commonly used in #S/360. For FORTRAN programmers, a brief example 
of the use of assembly-language routines with FORTRAN programs is 
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given in the IBM System/360 Operating System FORTRAN IV (H) Programmer's 
Guide (Form No. C28-6602) and in the IBM System/360 Operating System 
FORTRAN IV (G) Programmer's Guide (Form No. (28-6639). For programmer': 


using PL/1, a description of the linkage and parameter-passing conven- 


tions used is given in the IBM System/360 Operating System PL/1 F) 
Programmer's Guide, Form No. C28-6594. Additional information of' 


possible interest will be found in the IBM System/360 Operating System 
PL/1 Subroutine Library-PLM, Form No. Y28-6801. The PL/1 conventions 


are sufficiently complex so that most programmers will prefer not to 
use assembler-language programming except in extreme cases. It shoulda 
be noted that in the case of routines with only scalar arguments (no 
arrays, structures, or strings) the PL/1 linkage and argument-passing 
conventions are the same as the regular $S/360 conventions. If it is 
desired to maintain multiple entry points, it may be necessary to go 


to extra lengths. 


Routines which will later be used as part of a much larger program 
are occasionally difficult to debug because no I/O is to be performed 
for many levels of routine calls. In such a situation the PRINTQUT 
macro-instruction is often helpful, since virtually any quantity may 
be printed in an easily readable format, without worrying about 
destroying registers or the necessity for providing linkage registers. 
Siunbiariy: a simplified form of card input may be .performed using the 
READCARD macro-instruction. Both macros use the FORTRAN I/f package 
to perform the necessary formatting and conversion so that extra 
space will be required in the program's load module. Once the program 
has been debugged and the PRINT@UT and READCARD statements removed, 


the extra routines will not be required. 
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5. DEBUGGING 
5.1 Introduction 


The Computation Center realizes the need to present to the user some of 
‘the available resources and methods for debugging. The term debugging 
is meant here in the most general sense of trying to determine why a 
particular job did not execute. At the present, this section will 
briefly describe some of the resources available to the user for debug- 
ging, some of the common errors made by 360 programmers, and some 
helpful. hints for avoiding potential errors. In a future update to the 
User's Manual, this section will be elaborated to include more complex 


debugging procedures. 


os /360 provides a number of debugging aids as follows: 


1. A message reports an exceptional condition such as a programming 


or processing error. Messages appear in the output, informing 


the programmer of what is wrong in the program. 


2. A completion code is given to indicate why a task was abnormally 
terminated. 


3. A storage dump following abnormal termination is either (1) 
an indicative dump, which gives control information including 


the completion code or (2) an abnormal termination dump (ABDUMP), 


which includes control information as well as the contents of 


main storage at the time the job was abnormally terminated. 


4. In addition, a listing of object code produced and a map of 
modules loaded by the linkage editor can be very useful to the 
programmer in debugging his code. Listings and maps can be 
obtained by specifying the LIST and MAP options in the EXEC 
statement for the compiler or catalogued procedure involved. 
(Refer to Section 3 of this manual) Examples of formats for 
listings and maps are given in the "System Output" section of 


the appropriate Programmer's Guides. 


Revised February 1968 


5.2 Documentation 


1. 


IBM System/360 Operating System Messages, Completion Codes, and 
Storage Dumps, Form No. C28-6631. 


This document lists and explains the messages and completion codes 
produced by all IBM- supplied components of the operating system. 

It also describes the format of storage dumps. It is the basic 
reference for all debugging. Format of the diagnostic messages is 
explained in the Introduction. Messages are arranged alphabetically 
by their codes and are grouped according to the operating system 
component which issues them. For example, all messages from the 
FORTRAN IV (H) compiler start with the code IFK, all messages from 
the PL/1 (F) compiler with the code IEM. If the message text pro- 
vided in the program output is not self4explanatory, consult this 


manual for a'more detailed explanation. 


The Programmer's Guides for the language processor of interest to 
the user contains a list of messages produced by the processor in 


one of the Appendices. 


FORTRAN H “IBM System/360 0 erating System FORTRAN IV (H) 
Programmer's Guide, C2d-6602. Appendix D 


FORTRAN G IBM System/360 Operating System FORTRAN IV (G) 
Programmer's Guide, C28-66039. Appendix D 

Assembler IBM System/360 Operating System--Assembler 
Programmer's Guide, C26-3756. Appendix A 


PL/1 IBM System/360 Operating System PL/1 (F) 
Programmer's Guide, C2d-6594. Appendix G 


5.3 Notes | 


1. Programmers using FORTRAN G should check Appendix F of the Programmer's 
Guide (C28-6639) for a list of the debugging facilities available. 


2. MSGLEVEL=1 should always be specified in the J@B statement. This 
parameter causes all job control statements to be printed as part 
of the user's output, including the entire contents of the cata- 


logued procedure(s) used. 


3. Users should double check all job control statements to make sure 


that the required blanks are really there. For example, 
//FPRT.SYSIN DD* 


gives the error message IEF12lI CANNOT IDENTIFY VERB. 
The correct form of the statement would be //F@RT.SYSIN DD * 


hk, Don't try to WRITE on unit 5, or to READ unit 6. 


5. When using continuation cards for job control statements, the rules 
specified in Section 3.2.6 must be rigidly adherred to. In 
particular, failure to include the comma after a parameter before 

-. going to the next card, will cause that card to be read as a comment, 
and all parameters on that card will be lost. For example: 


//FIRSTGS EXEC FOPRTHCLG, PARM. FORT='DECK' x 
// PARM. LKED='XREF' 


The above statement would give a deck, but the cross-reference 
list specified on the second card would be ignored. The correct 
set-up for this statement should be 


//FIRSTGS EXEC FO@RTHCLG,PARM. FORT='"DECK', Xx 
// - PARM. LKED="XREF' 

6. Users should be aware that on the 360/67 core is not set to zero 
prior to job execution. To 7090 FORTRAN users, this means that 
uninitialized variables have unpredictable contents. If these 
variables are used as subscripts, program termination can result. 
The following program and the actual output show the danger of 


such a situation. 
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6. LIBRARIES 


6.1 Introduction 


As one of its responsibilities to the users, the Computation Center has 
undertaken the development and maintenance of program libraries in 
support of the user's computational needs. These libraries are divided 
into two general categories; i.e., the applications program Library 


classification and the subprogram library classification. 


The first of these will contain complete programs and their usage will 
only require the users to furnish the appropriate job control language 
set-up, any program control or option specifications required, and the 


data that he wishes to process. 


The second type of library will contain all of those programs which 
require the additional requirement of a driver or calling program. A 
subprogram generally performs only one task or a set of similar tasks 
and is used by the programmer as one of the "building blocks" within 
his program. A subprogram can either be a function Subprogram or a 
subroutine Subprogram. The function subprogram returns only the value 
of the function to the driver program while a subroutine subprogram can 


return the values of more than one argument. 


6.1.1 Sources of Programs 


In order to serve the current and future expanding needs of the users, 
the libraries will be in a continuous state of modification and expan- 
sion. The initial structure of the libraries was dictated by the 
requirements of the Center's past and current users. The Computation 
Center is also aware that deficiencies exist within the libraries. 
Consequently, provisions have been made for the users to submit any of 
their programs which receive frequent use or are standard operational 
routines for inclusion within the libraries. The programming standards 
and conventions are specified within this section of the Users Manual. 
Any program that is submitted must conform to these standards and be 
certified by the Center before it can be included within one of the 
libraries. Anyone wishing to submit a program may obtain a write-up 


form from the Users Services office, Room 156, Polya Hall. 


The user may also request that a program from another facility be con- 
sidered for inclusion in the Stanford Libraries. The aforementioned 


qualifiers for any such program must also be met. — 


In the event that a program does not exist or cannot be located that 
will perform a required task or set of tasks for the user, a written 
request can be made to the Computation Center specifying the need for 
such a program. If methodology is significant, it should be explicitly 
stated. All such requests will be reviewed by the Computation Center 


and the user will be notified of the action taken. 


6.1.2 Program Standards and Conventions 


Introduction 


In general, a program should be written in such a manner that anyone 
can read it, understand what it does, and make modifications to it with 
a minimum of effort. Even straightforward coding should contain pro- 
fuse comments and tricky coding should be explained in even greater 
detail. As experience has shown, it is often easier to rewrite a whole 
program than to make a small modification or correction to a program 
written by someone else. This duplication of effort must be eliminated 
for library programs -- the solution is to make the programs fully 
self-explanatory. The standards and conventions listed below will aid 


in accomplishing this goal. 


When preparing a program for inclusion in the Program Library, keep 
three things in mind. First, another individual who may wish to use 
the program will probably be thoroughly unfamiliar with it. Such an 
individual will want to be able to use the program with a minimum of 
study. He will want to know how to incorporate the program into his 
deck and what sort of accuracy, error messages, etc., he can expect. 
Second, an individual might wish to modify the program slightly for a 
specific use. In order for the program to be most useful to him it 
must be thoroughly documented. Third, individuals using the program 
library expect programs to be computationally sound and efficient. 
Programs included in the Program Library must utilize good programming 


practices. 


Comments 


Comments are the most important part of any program which is to be used 
by someone other than the original programmer (and even for your own 
programs if you want to read them at some later date). Remember, the 
listing of the program is generally the only reliable source. Comments 
should be profuse and not cryptic. They should be placed at ieast in 
the following places in a higher level language such as FORTRAN: 


i. The first few cards in any program or subprogram deck should 
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be a comment giving the following information: 
a. Title and name of the routine. 
b. Name of programmer (affiliation). 
c. The date. 
d. The modification level. 
For example, the first three cards of a deck could be: 
C LINEAR SYSTEM SUBRZUTINE, DECMPL 
C DECOMP¢SE A INTO LU 
C JQHN P. JONES (SCC) 2 MARCH 1967, MODIFICATION 3 


Any programmer who subsequently makes a modification to the 
source deck should add a comment giving his name and the date 
and a brief description of the modification. This provides an 
easy mechanism to keep historical records on library programs. 

2. Comments at the beginning of each program or subprogram., The 
comment should outline the purpose and method of the subsequent 
code and describe all parameters. 

3. Comments at the beginning of each block or segment of code 
that performs a particular task. For example, each non- 
trivial DO-loop should be commented. 

h, Comments at each branch point in a program. The reason for 
taking each branch and what will be done after branching there 
should be explained. 

5. Wherever else a comment can be placed to make absolutely clear 
what a particular statement is doing. The program with too 
many comments has not yet been written. 

6. At each CALL or funetion reference (except standard transcen- 
dental functions), there should be an indication of what 


actions are performed by the subroutine or function. 


When coding routines using an assembly language the above rules should 
be applied in addition to the following: 

1. Put a comment on every card. 

2. Any tricky coding should be fully commented. 

3. To reiterate what is specified above, be sure to put comments 


at the beginning of each program or subprogram, at the beginning 
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of each major segment of code, and at, all branch points to make 


the program completely readable. 


Variables 


1. Declarations: All variables and arguments must. be declared at the 
head of the subprogram, even when using compilers that declare by 
default. 

e. Identifiers: The identifiers (names) given to variables should 
be mnemonic with as much meaning as possible. The identifiers 
used in subprogram definitions should agree with those used on the 
write-up. Some examples of mnemonic variable names are: an 
increment in the X direction is usually identified as DX; in an 
eigenvalue procedure the matrix is usually denoted by A and an 
eigenvalue would be LAMBDA. In general, use long (6 characters 
for FORTRAN ) rather than short names, A good practice is to use 


the normal English names for the quantity. 


Names of Subroutines 
aot OF pubroutines 


Names of subprograms should be AAAAAd where A is an alpha character 
and d is a numeric digit. This allows updating a routine by adding 
one to the digit 'd'. Thus two (or more) versions of a routine can be 


maintained in the Library simultaneously without confusion. 


Parameter Lists Ordering 
a ree ring 


The ordering of parameters in a subprogram call should be: 
input parameters first, 
Output parameters second. 
Label parameters last. 
For example: <A matrix product routine (MPROD ) could be called as 
MPROD(N, A, B, C) 
where A and B are square matrices of dimension N and their product 
is stored in the matrix C , Thus, N, A, and B are input parameters 


and © is the output parameter. 
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Indentation 


Indentation should be used to indicate thescope of various constructs 
in a program. This can be applied to FORTRAN code as well as other 
languages. For example, consider the following nonsense program segment: 
Dd 10 I = a N 
eX 
D6 9T= 1, N 
Yoeee Yu DY: 
Z=2+ Ds 
9 ANS(I,J)=Y**) + 7%*h 
B(I) = c{I) * x 
10° CONTINUE 
11 CONTINUE 


T/O in Subprograms 


Avoid any input or output within a subprogram. Instead, pass the 


information through the parameters or arguments. 


Use label parameters to indicate errors or non-standard: oecurences 
within subprograms. For example, instead of printing an error message 
in the subprogram return to the calling program via a label parameter. 
This allows the calling program tio decide what action to take in the 


ease of an error. 


Register Usage in 360 Subprograms 


For register usage conventions refer to the following TBM documents. 
For use with FORTRAN: 


For use with PL/i: 


360 Operating System PL/1 
028-659 


CF) Programmer's Guide, 
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Material to be included for each program or subprogram for the Program | 


Library 


1. Completed write-up form. 

2. The source deck. 
A binary deck (if applicable). 

4. A listing of the source deck. 

>» <A driver program which does as many test cases as necessary to 
completely check the Operation of the program. 

6. A listing of a successful run with the driver program with 
enough comments that a person can tell whether the printed results 


are what should have been produced. 
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6.2 Stanford Extrinsic Program Library 


6.2.1 Introduction 


The Stanford Extrinsic Program Library is a library of subprograms devel- 
oped and written by the Computation Center. These subprograms may 
supplement as well as overlap those of the Scientific Subroutine Package. 
The intent of those programs which duplicate any tasks of the Scientific 
Subroutine Package is that of providing a more efficient and more current 


state-of-the-art program. 


All subprograms in the Extrinsic Program Library are entered by the 
Standard FORTRAN calling statements. The user is reminded that he must 
furnish, as part of his calling program, all 1/o and other operations 


necessary for the toial solution of his problem. 


Any subprogram contained within the Stanford Extrinsic Program Library 
has gone through a process of certification. This process implies the 
successful completion of a sufficient number of test runs which, in 
general, utilize all the significant options and controls of the sub- 
program. Within the structure of these test cases, the subprogram also 
has demonstrated no syntactical or logical errors. The final step of 
the certification procedure requires that the subprogram be tested by 

a@ programmer other than the source programmer. This testing includes 


such qualifiers as: 


1. The documentation explaining the subprogram is adequate, well 
written and descriptive. 


2. The subprogram performs as advertised in the documentation. 


6.2.2 Obtaining Library Programs and Documentation 


All of the announced subprograms exist on the 2314 disk in source form. 
The user can obtain these programs directly by using the utility program 
IEBPTPCH. Either source decks and/or source listings are available. 
Details on the use of IEBPTPCH and the job control language set-up for 
obtaining source decks and/or listings can be found in Seerion Blk; 


‘Utilities', of this manual. 
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Write-ups for these subprograms are available from the Systems Documen- 
tation Office, Room 185, Pine Hall, Ext, 4877. 


Copies of any of the programs contained in the Stanford Computation 
Center Program Library may also be ordered through the Campus Facility 
User Services Group, Room 156, Polya Hall. There is a charge for this 
service as follows. 


° A service charge of $50.00 will be levied for each order 
regardless of the number of routines requested. 

ro) In addition, a charge of $1.00 per 1000 card images will be 
levied for output on tape. 

e) If the buyer fails to provide his own tape, we will supply 
tape at the rate of $27.00 per 2400 foot reel, 

° If card output is requested, a charge of $5.00 for the first 
1000 cards plus $1.25 per each 1000 additional cards, plus 
actual postage, will be levied, in addition to the $50.00 . 
service charge. 


Persons wishing more information on the programs available through this 
service should contact the Campus Facility User Services Group, Room 156, 
Polya Hall, Stanford Computation Center, Stanford, California. 
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6.2.3 
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Available Programs 


The following Extrinsic Library subprograms are available. The member 


name(s) are also given for each program. 


Program 
Number 


€ O01 


Cc 002 


C 003 


Cc 004 


C 005 


C 007 


Cc 008 


Member 


Name(s) 


GCD1L 


NXPL 


VPR2 


DPRIR 


DPRLU 


DPR2 


EDNUM 


MARQ1 


Title and Description 


Greatest Common Divisor - This function subprogram 
finds the absolute value of the greatest common 
divisor of two integer arguments using Euclid's 
algorithm. 


Next Prime Number Routine ~ NXPl finds the next 
prime number larger than the integer argument 
supplied by the calling program. 


Double Precision Inner Product Accumulation - This 
routine forms the double-long product of two long 
floating-point arguments and adds it to a double- 
long sum, and provides a simple indication of 
exponent overflow and underflow. 


Double Precision Product Accumulation with Optional 
Rounding - This subroutine subprogram computes the 
long precision of two long precision floating-point 
arguments with optional rounding and provides a 
simple indication of exponent overflow and underflow. 


Product Accumulation for Short and Long Floating- 
Point Operands - This subroutine subprogram computes 


_ the long precision product of a short and a long 


precision floating-point number; the product replaces 
the long precision operand, and a simple indication 
is given of exponent underflow and overflow. 


Convert Integer Variables to an Edited Print Format 
- This program converts integer variables to EBCDIC 
(alphanumeric) characters, suppressing leading 
zeroes and inserting commas and dollar signs or 
asterisks, as desired. 


Least Squares Estimation of Nonlinear Parameters 
(Marquardt, D. W.) - The Fortran subroutine can be 
used to (1) estimate nonlinear parameters in a 
statistical model, or (2) solve a system of simul- 
taneous nonlinear equations by minimizing 


k 
2 
f° 
xX a 
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Program Member 


Number Name(s) Title and Description 


C 008 (continued) with the independent variables as parameters. The 
subroutine uses the first partial derivatives of 
the function(s) which are evaluated by a function 
subprogram which is a parameter to MARQI] . 


Cc 009 MULLR1 Muller's Method - Subroutine MULLR1 finds complex 
roots of an arbitrary function of one complex vari- 
able. 


C O1L _QUADS1 Integration of a Real Function of One Variable by 
Classical Quadrature ~ This function subprogram 
approximates the integral of a real function of 
one variable by a given classical quadrature rule: 


UPPER ‘ 7 
J Funer(x)ax  } w, FUNCT (t 


“) 
LOWER j=l : 


The kind of quadrature rule (e.g., Gauss, Hermite, 
Newton-Cotes, etc.), the weights and abscissas are 
supplied by the User in the simplest form. 


Cc 013 QUADM1L Multiple Integration of a Real Function of N  vari- 
ables by Product Rule Quadrature - The function of 
subprogram QUADM] approximates the multiple integral 
of the form 


p Ye 
es anc re rg 
it Ly 


Uys» Koy very xy_ 


me : ee Fyl Xz Koy sey Xqy) yy woe Ox, Gx, 
1 ee. Pe 


by repeating the quadrature rule supplied a specified 
number of times for each integration (i.e., producing 

a product quadrature rule). The lower and upper limit 
functions and the integrands are supplied by REAL FUNC- 
TION subprograms. 
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Program 
Number 


C O14 


C O15 


C 016 


C O17 


Cc 018 


C 019 


C 021 


Member 
Name(s) 


QUADS3 


DFEQS1 


INTRP1 


BESSLL 


HRMIT1L 


LAGRN1L 


DCOMP1 
LSSQs1 
SOLV1 - 
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Title and Description 


Numerical Integration of Adaptive Quadrature - This 
real function subprogram approximates the integral 
of the function FUNCT between the limits of LOWER 
and UPPER by applying Simpson's rule and Romberg 
correction to various length subintervals as dictated 
by the integrand and the tolerance EPSLON . 


Solve a System of First Order Ordinary Differential 
Equations by the Kutta-Merson Method - This sub- 
routine subprogram uses the single step method of 
Kutta-Merson to approximate the solution of a system 
of n first order differential equations, 


dy 
ax” F(X,Y) . 


Automatic error control (step size control) is 
available if requested. 


Newton's Forward and Backward Interpolation for 
Equally Spaced Points - Given a table of values of 
a function F(x) at a set of equally spaced values 
of x, this procedure uses Newton's Forward and 
Backward Interpolation formulas to determine the 
value of F(x) for any value of x in the allow- 
able range. 


Bessel's Interpolation with Equally Spaced Points - 
Given a table of values of a function F(x) ata 
set of equally spaced values of x, this procedure 
uses Bessel's interpolation formula to determine the 
value of F(x) for any value of x in the range. 


Hermite Interpolation - This procedure evaluates, 
at a given abscissa, a (2N+1)th-degree Hermite 
polynomial passing through N+l points. The first 
derivative of the polynomial at each of the N+1 
points must be given to the procedure. 


Lagrange Interpolation - This procedure evaluates, 
at a single abscissa, an Nth-degree Lagrange poly- 
nomial passing through MN+l points. 

Linear Least Squares Problem Solver - These sub- 
routines solve the linear least squares problem 


I Ax - b ll, = minimun, 
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Program Member 
Number Name(s) Title and Description 


C 021 (continued) where || - |l> indicates the euclidean vector norm 
and A is an mxn (m>n) real matrix of rank 
n. <A matrix decomposition based on orthogonal 
Householder transformation is used rather than 
solving the normal equations 


Atax = Alb. 


Several vectors, b, may be given for solution at 
once to increase efficiency. 


C 022 DECMP1 Subroutine Package for Linear Systems Solution, 

DETER1 Matrix Inversion and Determinants - By decomposing 
IMPRV1 the given square matrix A. into two triangular 
INVRT1 matrices L and U such that LU =A, these sub- 
LINSY1 routines supply approximate solutions to the prob- 
SOLVE1 lems: 

1. find the vector x such that Ax =b, where 

b is a given vector; 
2. find the matrix V such that AV=1, where 


1 is the identity matrix; 
3. find determinant (A) . 


Problem 1 can be solved efficiently for many right- 
hand sides b after the initial decomposition of 

A. Iterative improvement of each solution x may 
be specified. Matrix singularity and near singu- 
larity are reported; an accuracy measure is supplied 
following iterative improvement and exponent overflow 
and underflow during the determinant calculation is 
-conveniently handled. 


C 023 AXIS1L 0S/360 Plotting on the CALCOMP Plotter - These 
ENDPL | twelve subroutine subprograms perform a general 
FACTRL purpose set of plotting tasks. They use the 570 
LINE1 CALCOMP System to output the resultant plot(s). 
NUMBR1 
OFFSTL 
PLOTS1 
PLOT1 
SCALE1L 
STRTPL 
SYMBL1 
WHERE 
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Program 
Number 


C 024 


C 025 


C 026 


C 027 


c 028 


C 030 


C 0351 


Member 


Name(s) 


CURVEL 
GRAPH1L 
POINT 
TITLE1L 


LOGAX1 
LIMIT1 


HEX2 


SHFLLA 
SHFLLC 
SHFLLL 
SHFLRA 
SHFLRC 
SHFLRL 


SHFeL 
SHF2R 


LGOLAN 
LGOLCM 
LGOLOR 
LGO1LXR 


MVC1 


IRND1L 
IRND1S 
RNDILS 
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Title and Description = 
Graphing of One Variable Functions (Curve Plotting) © 
on the CALCOMP Plotter - These subroutines use the 
basic CALCOMP plot subroutines to draw curves and 
label graphs of points suppiied as (x, pairs. 
The points for each curve are collected by the sub- 
routine POINT] ; the subroutine CURVE] is called 
to give the style and symbol to be used for each 
curve to be on the next graph. Subroutine TITLEL 
may be called to place a heading on the next graph. 
A call to subroutine GRAPHI labels the axis, if 
requested, scales and plots all curves as specified, 
then moves the paper to prepare for the next graph. 


Logarithmic Axis Plotting for the CALCOMP Plotter 
- These subroutines can be used to plot a scaled 

axis on the CALCOMP Plotter with logarithmically 

placed tic marks. 


Hexadecimal to EBCDIC Conversion Routine for 
Extended Arguments - This routine converts a string 
of hexadecimal digits into a string of EBCDIC 
characters which represent the hex digits. 


Shift Routines for Fullword Operands - These function 
subprograms provide the Fortran programmer with the 
capability of performing arithmetic, logical and 
circular snifts of any number of binary positions 

on any fullword operands. 


Shift Routines for Doubleword Operands - These 
function subprograms provide the Fortran programmer 
with the ability to perform logical shifting 
operations on doubleword operands by an arbitrary 
number of binary positions. It is closed, re-entrant, 
double-precision type of function subprograms, 
standard 0S/360 entry. 


Logical Operations of Fullword Operands - This 
function subprogram provides the logical operations 
AND, OR, EXCLUSIVE OR, and ONE'S COMPLEMENT 
(BITWISE COMPLEMENT) on fullword operands. 


Fortran Move-a-byte Routine - This subroutine sub- 
program allows the Fortran programmer to move any 


byte in storage to any other byte. 


Rounding Functions for Long and Short Precision 


‘Arguments - These subprograms provide the three 


functions: 
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Program 
Number 


Member 


Name(s) 


C 031 (continued) 


C 033 


C O34 


C 035 


C 036 


C 057 


C 039 


Cc oho 


C OL 


ABD1 


Revised May 1968 


Title and Description 


1. round a long precision floating-point number to | 
short precision, 


2. round a short precision floating-point number 
to the nearest integer, and 


3. round a long precision floating-point number to 
the nearest integer. 


Abnormal~End Program Terminator - This short program 
allows the Fortran programmer to terminate his pro- 
gram with an ABEND macro-instruction, and there- 
fore to obtain a dump of storage at the time of the 
call. 


Fortran Read-Write Simulation and Internal 1/0 
Buffer Control - This routine allows a Fortran pro- 
grammer to perform I/0 conversions to and from 
specified buffer areas in memory without an accom- 
panying 1/0 operation on a physical device. 


Printout Macro-instruction - The PRINTOUT macro- 
instruction provides the machine language programmer 
with a simple means of obtaining debugging, diagnostic, 
and other useful output with an absolute minimum of 
effort. - 


PARM Field Type Out Routine - WTOPARM is a stand 
alone program which will display on the typewriter 
the contents of the PARM field from the EXEC 
statement of the Job Control Language. 


Readcard Macro-instruction - READCARD provides a 
simple means of reading 80 bytes from a data card 
into a buffer in the Users' program. 


Date and Time Fortran Function - This integer type 
function subprogram will supply the year, day, and 
time of day in three formats ( HHMMSSth, hundredths 
of a second, and timer units). 


Uniform Random Number Generator - This subroutine 
generates a sequence of uniformly distributed 
random numbers, either integer (on the interval 
(0, 251-1) ) or real (on the interval (0, 1) ). 


Fortran Run-Time Error Trace and Diagnostic Routine 

- This routine provides the Fortran programmer with 
diagnostic information at the time certain errors 
occur, in a format which simplifies program debugging 
and error tracing. 
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Program 
Number 


C Oh; 
C Ob 
C O45 


C O46 


C O47 


C O48 


Member 
Name(s) 


A2INT 


EPILOGUE 
JREPREPO 
PROLOGUE 


‘SYMVVL 


SYMV1 


PRINTLINE 


Revised May 1968 


Title and Description 


Alpha to Integer Conversion - This routine converts 
a string of one to four byte characters, read in 
under an alphanumeric format, to an integer. 


Prologue and Epilogue Macro-instructions - These 
macro-instructions will considerably simplify pro- 
gram debugging for beginning Assembler language 
programmers; useful diagnostic information is pro- 
vided for all program interruptions. 


Eigenvalue and Eigenvectors of a Symmetric Real 
Matrix by the QR Method - This subroutine finds all 
the eigenvalues and eigenvectors of a symmetric 
real matrix by Householder Tridiagonalizeation, and 
the QR method. 


Eigenvalues of a Symmetric Real Matrix by the QR 
Method - This subroutine finds all the eigenvalues 
of a symmetric real matrix by Householder Tridiag- 
onalization, followed by a stable square-root free 
version of the QR method. . 


Eigenvalues of a Nonsymmetric Real Matrix by the 
QR Method - This subroutine finds all the eigen- 
values of an arbitrary real matrix. The matrix is 
reduced to Hessenberg form; then the eigenvalues 
are found by the QR method. If the matrix is 
known to be symmetric, use subroutine SYMV1L 
(Library Program No. C O46). 


PRINTLIN Macro-instruction for Simplified Single 
or Multiple-line Output from Assembler Language 
Programs - This macro-instruction allows a program~- 


mer to write preformulated character strings on a 


printer or other output medium with a minimum of 
worry about details of data management and Job 
Control Language. 
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6.3 Scientific Subroutine Package 
6.3.1 Introduction 


The Scientific Subroutine Package is a manufacturers Supplied item. It 
is a collection of over 200 FORTRAN subroutines divided into two groups: 
statistics and mathematics. The subroutines are input/output-free com- 
putational building blocks that can be combined with a user's input, 


output, or computational routines to meet his needs, 


All subroutines in this package are entered by means of the standard 
FORTRAN CALL statement. Since the SSP is available in the system, no 


external decks or control cards are required. 


These subroutines are purely computational in nature and do not contain 
any references to 1/o devices. The user must furnish, as part of his 
calling program, all I/O and other operations necessary for the total 
solution of his problem. In addition, the user must define all matrices 


to be operated on by SSP subroutines as well as those matrices utilized 


in his program. These matrices must conform to the requirements set 
forth in the SSP Programmers Manual. Ali of the normal rules for FORTRAN 


concerning subroutines must be observed. 


6.3.2 Documentation 


The subroutines contained in the package are described in the System/360 


Scientific Subroutine Package - Programmers Manual (Form No. H20-0205). 


Personal copies of this manual can be obtained from the Systems Documen- 
tation Office, Room 185, Pine Hail. 


- __—Reviséd’ February 1968 


6.3.3 Available Programs 


The following SSP programs are available for use. 


Data Screening 


TALLY totals, means, standard deviations, minimums, maximums 
BOUND selection of observations within bounds 
SUBST subset selection from observation matrix 
ABSNT . detection of missing data 
TABL tabulation of data (1 variable) 
TAB2 tabulation of data (2 variables) 
SUBMX build subset matrix 
Elementary Statistics 
MOMEN first four moments 
TTEST tests on population means 
Correlation 
CORRE means, standard deviations, and correlations 
Multiple Linear Regression 

~ ORDER rearrangement of intercorrelations 
MULTR multiple regression and correlation 
Polynomial Regression 
GDATA data generation 
Analysis of Variance 
AVDAT data storage allocation 

_ AVCAL Sigma and delta operation 
MEANQ mean Square operation 
Discriminant Analysis 
DMATX oe means and dispersion matrix 
DISCR discriminant functions 
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Factor Analysis 


TRACE cumulative percentage of eigenvalues 
LOAD factor loading 
VARMX varimax rotation 


Time Series 


AUTO autocovariances 

CROSS crosscovariances 

SMO application of filter coefficients (weights) 
EXSMO triple exponential smoothing 


Nonparametric Statistics 


CHIS@ Chi-square test for a contingency table 
UTEST Mann-Whitney U-test 

TWOAV Friedman two-way analysis of variance 
QTEST Cochran Q-test 

SRANK Spearman rank correlation 

KRANK Kendall rank correlation 

WIEST Kendall coefficient of concordance 

RANK rank observations 

TIE calculation of ties in ranked observations 


Canonical Correlation 


CANOR canonical Correlation 


NROOT eigenvalues and eigenvectors of a special non- 
symmetric matrix 


Special Matrix Operations 


MINV matrix inversion 

EIGEN eigenvalues and eigenvectors of a real, symmetric matrix 
MFGR, puror'‘*? matrix factorization and rank determination 

Matrices 

GMADD add two general matrices 

GMSUB subtract two general matrices 

GMPRD product of two general matrices 

GMTRA transpose of a general matrix 
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transpose product of two general matrices 
add two matrices 

subtract two matrices 

matrix product (row into column) 

transpose a matrix 

transpose product. 

transpose product of matrix by itself 

add scalar to matrix 

subtract scalar from a matrix 

matrix multiplied by a scalar 

matrix divided by a scalar 

add row of one matrix to row of another matrix 
add column of one matrix to column of another matrix 
scalar multiply row and add to another row 
scalar multiply column and add to another column 
interchange two rows 
interchange two columns 

sum the rows of a matrix 

sum the columns of a matrix 

tabulate the rows of a matrix 

tabulate the columns of a matrix 

sort matrix rows 

sort matrix columns 

partition row-wise 

partition column-wise 

adjoin two matrices row-wise 

adjoin two matrices columm-wise 

matrix copy 

copy submatrix from given matrix 

copy row of matrix into vector 

copy column of matrix into vector 

copy diagonal of matrix into vector 

matrix clear and add scalar 

replace diagonal with scalar 


storage conversion 
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LOC 
-CONVT 


ARRAY 


Integration and Differentiation 


QTFE, DOFG 
QTFE, DQFE 
QSF, DQSF 
QHFG, DQHFG 
QHFE, DQHFE 
QHSG,” DQHSG 
QHSE, DQHSE 7 
QATR, DQATR 
ace gs (2 
Qc QG5 
QG6: QG7 
Qcs QG9 
QG1O ~=—-_-» DAG 
pecs ~=s-«- Dagie 
DQG16 = DaGek 
DeGs2 

QL2 QL3 
QI QL5 
QL6 QL7 
Qs QL9 
QlLlo =—-—s DQ 
DaL8 =s-_-s DALI 
DQL1I6 §=DeLa} 
DQI32 
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j 
4 


matrix transformation by a function 
reciprocal function for MFUN 

location in compressed-storage matrix 

single precision-double precision conversion 


vector storage-double dimensioned storage conversion 


integration of monotonically tabulated function by 
trapezoidal rule : 


integration of equidistantly tabulated function by 
trapezoidal rule ; 


integration of equidistantly tabulated function by 
Simpson's rule 

integration of monotonically tabulated function with 
first derivative by Hermitian formula of first order 


integration of equidistantly tabulated function with 
first derivative by Hermitian formula of first order 


integration of monotonically tabulated function with 
first and second derivatives by Hermitian formla of 
first order 


integration of equidistantly tabulated function with 
first and second derivatives by Hermitian formula of 
second order if 
integration of a given furiction by trapezoidal rule 
together with Romberg's extrapolation method 


+ 


integration of a given function by Gaussian quadrature 


formulae 


integration of a given function by Gaussian-Laguerre 
formulae 
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Integration and Differentiation (continued) 


QH2 QH3 
QH4 QH5 
QH6 QH7 
QH8. QHO 
QH1O DQH8 
DQH16 DQHek 
DQH32 = =©DQHKB 
DQH64 

QAe QA3 
QAL QA5 
QA5 QA7 
QA8 QA9 
QA10 DQA4 
DQA8 DQA12 
DQAl6 DQAH 
DQA32 


integration of a given function by Gaussian-Hermite 
quadrature formulae 


integration of a given function by associated Gaussian- 
Laguerre quadrature formulae 


Ordinary Differential Equations 


RK1L 
RK2 


-RKGS, DRDGS 
HPCG, DHPCG 
HPCL, DHPCL 


LBVP, DLBVP 


Fourier Analysis 


FORIF 
FORIT 

HARM, DHARM 
RHARM, DRHARM 


solution of first-order differential equation by Runge- 
Kutta method 


tabulated solution of first-order differential equa- 
tions by Runge-Kutta method 


solution of system of first order ordinary differential 
equations with given initial values by the Runge-Kutta 
method — 


solution of peace lata of first order ordinary 
differential equations with given initial values by 
Hamming's modified: predictor-corrector method 


solution of linear system of first order ordinary 
differential equations with given initial values by 
Hamming's modified predictor-corrector method 


solution of system of linear first order ordinary 
differential equations with linear boundary: conditions 
by method of adjoint equations 


Fourier analysis of a given function 
Fourier analysis of a tabulated function 
complex three-dimensional analysis 


real one-dimensional analysis 
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Special Operations and Functions 


GMMMA 
BESJ 

BESY 

BESI 

BESK 

EXPI 

SICI 

cs 

CELL, DCEL1 
CEL2, DCEL2 
ELI1, DELI 
ELI2, DELI2 
JELF, DJELF 


Linear Equations 


SIMQ 
GELG, DGELG 


GELS, DGELS 
GELB, DGELB 


LLSQ, DLLSQ 


gamma function 

J Bessel function 

Y Bessel function 

I Bessel function 

K Bessel function 

exponential integral 

Sine cosine integral 

Fresnel integrals 

complete elliptic integral of the first kind 
complete elliptic integral of the second kind 
generalized elliptic integral of the first kind 
generalized elliptic integral of the second kind 


Jacobian elliptic functions 


solution of simultaneous linear, algebraic equations 


system of general simultaneous linear equations by 
Gauss elimination 


system of general simultaneous linear equations with 
symmetric coefficients 


system of general simultaneous linear equations with 
band structured coefficients 


solution of linear least squares problems 


Non Linear Equations 


RTWI, DRTWI 
RIMI, DRTMI 
RTNI, DRTNI 
FMFP, DFMFP 


FMCG, DFMCG 


refine estimate of root by Wegstein's iteration 
determine root within a range by Mueller's iteration 
refine estimate of root by Newton's iteration 


unconstrained minimum of a function of several variables 
-- Davidson method 


unconstrained minimum of a function of several variables 
~~ conjugate gradient method 


Roots of Polynomials 


POLRT 
PRQD, DPRQD 


real and complex roots of a real polynomial 


roots of a real polynomial by QD algorithm with 
displacement 
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Special Polynomials 


CNP, DCNP 
CNPS, DCNPS 
-TCNP; DICNP 


CSP, DCSP’ 
CSPS, DCSPS 
TCSP, DTCSP 


HEP, DHEP 
HEPS, DHEPS 
THEP, DTHEP 


LAP, DLAP 
LAPS, DLAPS 
TLAP, DTLAP 


LEP, DLEP 
LEPS, DLEPS 
‘TLEP, DTLEP 


value of Nth Chebyshev polynomiAl 
value of series expansion in Chebyshev polynomials 


transform series expansion in Chebyshev polynomials to 
a polynomial 


value of Nth shifted Chebyshev polynomial 
value of series expansion in shifted Chebyshev polynomials 


transform series expansion in shifted Chebyshev polynomials 
to a polynomial 


value of Hermite polynomial 
value of series expansion in Hermite polynomials. 


transform series expansion in Hermite polynomials to a 
polynomial 


value of a Laguerre polynomial 
value of series expansion in Laguerre polynomials 


transform series expansion in Laguerre polynomials to 
a polynomial 


value of Legendre polynomial 
value of series expansion in Legendre polynomials 


transform a series expansion,in Legendre polynomials to 
a polynomial - 


Polynomial Operations 


add two polynomials 


multiply polynomial by constant and add to another 
polynomial 


replace one polynomial by another 

subtract one polynomial from another 

multiply two polynomials | 

divide one polynomial by another 

quadratic synthetic division of a polynomial 

value of a polynomial 

substitute variable of polynomial by another polynomial 
complete linear synthetic division 

evaluate polynomial and its first derivative 

derivative of a polynomial 


integral of a polynomial 
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PGCD greatest common divisor of two polynomials 

PNORM normalize coefficient vector of polynomial 

PECN, DPECN economization of a polynomial for symmetric range 
PECS, DPECS economization of a polynomial for unsymmetric range 
Approximation, Interpolation, Table Construction 

ALI, DALIT Aitken-Lagrange interpolation 

AHI, DAHT Aitken-Hermite interpolation 

ACFI, DACFI continued fraction interpolation 

ATSG, DATSG table selection out of a general table 

ATSM, DATSM table selection out of a monotonic table 

ATSE, DATSE table selection out of an equidistant table 
Convergence Accelerating Operations 

TEAS, DTEAS limit of a given sequence 

TEUL, DTEUL sum of a given function sequence 


Random Number Generators 


RANDU uniform random numbers 
GAUSS normal random numbers 
NOTES 


(1) Where there are two subroutine names separated by a comma, the first, 
is the single precision version and the second is the double precision 
version. This notation also serves to identify the Version 2 
additions to SSP/360. 


(2) In each family of quadrature formulae, the factor that differs is the 
number of points used. Also, Q designates single precisioi 


subroutines and D designates double precision subroutines. 
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6.4 Applications Program Library 
6.4.1 Biomedical Computer Programs (BMD) 


6.4.1.1 General Information 
eras ntormation 


The Biomedical Computer Programs (BMD) are a set of complete programs 
designed to serve the following needs: 

l. To provide programs for the commonly used tasks of data 
processing and statistical analysis. 

@. To provide programs in a "package" form so that researchers 
may achieve their desired computations with simple coded 
instructions. 

5. To provide "package" programs in a general form so that a 
wide variety of problems may be handled by each program 
simply by specifying the appropriate parameters of the. 


‘problem. 


The BMD programs were obtained from the UCLA Health Sciences Computing 
Facility... Since this was not a Stanford developed system, it was 
necessary to verify the reputed performance of the programs. They were 
run with the test data provided in the BMD manual and the resultant 
output checked against the manual's test results. An agreement of 
four significant places was an average for these comparisons. The 
dissimilarity in the results could be caused by the difference in word 
length size between the TBM 7090. and the IBM 500/67» ivesg-8 32-bit 

word for the 360/67 and a 36-bit word for the 7090. The other noticeable 
| difference is that missing integer data was represented by a -O on the 
7090, but appears as a O on the 360/67. This occurs because there igs 
no possible representation for an integer -O on the IBM 360/67. 


Although we are relying on UCLA for maintenance of these programs, 
users are encouraged to report any difficulties encountered to Arline 


Kapphahn, User Services Group, Room 185, Pine Hall. 


74.1.2 Documentation 


These programs are described in the Biomedical Computer Programs 


publication which is available from the Stanford Bookstore. 


6-2h 


Revised February 1968 


Reference copies of this manual are available in the Computer Science 


Library and the study room in the Dispatch lobby. 


6.4.1.3 Available Programs 


The following BMD programs are now available for use on the Campus 
Facility's 360/67 computer. 


Class D-Deseription and Tabulation 


BMDOLD Simple data description 

BMDC2D Correlation with transgeneration 

BMDO4SD Correlation with item deletion 

BMDO4D Alphanumeric frequency count 

BMDO5D General plot including histogram 

BMDO6D Description of strata 

BMDO7D Description of strata with histograms . 
BMDO8D Cross-tabulation with variable stacking 

BMDOQD Cross-tabulation, incomplete data 

BMD1OD Data patterns for dichotomies 


BMD11D Data patterns for polychotomies 


Class M-Multivariate Analysis 


BMDC1M Principal component analysis 

BMDO2M Regression on principal components 
BMDO3M Factor analysis 

BMDO4M Discriminant analysis for two groups 
BMDO5M Discriminate analysis for several groups 
BMDO6M Canonical analysis 

BMDO7M Stepwise discriminant analysis 


Class R-Regression Analysis 


BMDOLR Simple linear regression 

BMDO2R Stepwise regression 

BMDOSR Multiple regression with case combinations 
BMDO4R Periodic regression and harmonic analysis 
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BMDOSR Polynomial regression 
BMDO6R Asymptotic regression 


Class S-Special Programs 


BMDOIS _ Life table and survival rate 
BMDO2S Contingency table analysis 

BMDO38S Biological assay: probit analysis 
BMDO9S Transgeneration 


BMD1OS Transposition of large matrices 


Class T-Time Series Analysis 
BMDOLT Amplitude and phase analysis 


BMDO2T Autocovariance and power spectral analysis 


Class V-Variance Analysis 


BMDO1V Analysis of variance for one-way design 

BMDO2eV Analysis of variance for factorial design 
BMDO3V Analysis of covariance for factorial design 
BMDOLV Analysis of covariance with multiple covariates 
BMDO5V General Linear hypothesis 

BMDO6V General linear hypothesis with contrasts 
BMDO8V Analysis of variance (new program) 


Class X-Supplementary Programs 


BMDX63 Multivariate general linear hypothesis 
BMDX64 - General linear hypothesis 

BMDX65 Substitute means for missing values 
BMDX69 Multivariate analysis of variance and covariance 
BMDX70O T-test and F-test program 

BMDX71 Non-linear least squares estimation 
BMDX72 Factor analysis 

BMDX73 Multiple time series spectral estimation 
BMDX74 Identification of outliers 

BMDX75 Canonical analysis 

BMDX76 Life tables and survival rate 
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BMDO5R Polynomial regression 
BMDO6R Asymptotic regression 


Class S-Special Programs 


BMDO1S _ Life table and survival rate 
BMDO02S Contingency table analysis 

BMDO4S Biological assay: probit analysis 
BMDO9S Transgeneration 

BMD10S Transposition of large matrices 


Class T-Time Series Analysis 
BMDOLT Amplitude and phase analysis 


BMDOeT Autocovariance and power spectral analysis 


Class V-Variance Analysis 


BMDOLV - Analysis of variance for one-way design 

BMDO2V Analysis of variance for factorial design 
BMDO3V Analysis of covariance for factorial design 
BMDOLV Analysis of covariance with multiple covariates 
BMDO5V General linear hypothesis 

BMDO6V General linear hypothesis with contrasts 
BMDO8V Analysis of variance (new program) 


Class X-Supplementary Programs 


BMDX63 Multivariate general linear hypothesis 
BMDX64 General linear hypothesis 

BMDX65 Substitute means for missing values 
BMDX69 Multivariate analysis of variance and covariance 
BMDX70 T-test and F-test program 

BMDX71 Non-linear least squares estimation 
BMDX72 Factor analysis 

BMDX73 Multiple time series spectral estimation 
BMDX74 Identification of outliers 
BMDX75 Canonical analysis 

BMDX76 Life tables and survival rate 
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BMDX77 Transgeneration 

BMDX80 Mean frequency epoch analysis 

BMDX84. Asymetrical correlation with missing data 
BMDX85 Nonlinear least squares 


6.4.1.4 BMD Job Set-up 
The BMD programs are included in the Applications Program Library and 
the Source Library. The following job set-ups will allow you to 


process data from cards or tape, respectively. 


1. Sample deck set-up for executing a BMD program with the input data 
and control statement on cards. 


User's data and BMD control cards 


//GP.SYSIN A DD A * 


//stepname A EXEC A BMD , PARM=abe 


//JOBLIB A DD A DSNAME=SYS2 . PROGLIB, DISP=OLD 


// Job Card 
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6.4.2 Electronic Circuit Analysis Program (ECAP) 


The IBM Electronic Circuit Analysis Program, ECAP, is a general circuit 
analysis program allowing DC, AC, and transient analyses of circuits with 
up to 50 nodes and 200 branches. Use of the program can facilitate the 
analysis of most any system for which an electrical analog can be speci- 
fied. Node voltages, element currents, and power dissipation are typi- 


cally determined from a circuit-oriented description of the network. 


Currently the program can be entered into the batch stream from either 
the WYLBUR terminals or the card readers. 


Documentation for this program is the IBM manual Electronic Circuit 


Analysis Program User's Manual (Form No. H20-0170). The documentation 


is available from the Systems Documentation Office, Room 185, Pine Hall. 
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6.4.3 Linear Programming System (LPS) 


A Linear Programming System, which is a part of IBM's Mathematical Pro- 
gramming System, is available for use on the 360/67. This system con- 
sists of a compiler and an executor. The compiler accepts programs 


written in a special linear programming language which consists of: 


o Procedures which execute and maintain problem files consisting 
of coefficient matrices, multiple right hand Sides, multiple 
objective functions, multiple bounds, rows and range columns, 


and starting bases. 


o Procedures which find an optimum solution. Primal and dual al- 
gorithms are provided. The primal uses a revised simplex (pro- 
duct form of the inverse) algorithm with bounded variables and 


range constraints. 


© Procedures which do post-optimal studies. Ranging, perturbing 
the objective function, the right hand side, or any row or col- 


umn is provided. These things can be done simultaneously. 


o Statements which change certain constants and sub-procedures 


within the system. 


The executor takes the output of the compiler and executes the indica- 
ted procedures using data provided by the user in the input stream and 


other data which the user has placed in the system from past runs. 


The system will handle problems with at least 2,048 rows and virtually 
infinite columns. The optimization algorithms are extremely efficient. 
A small problem (14 constraints and 21 variables) was optimized in less 


than .O1 minutes. 


Documentation is available from the Systems Documentation Office, Room 
185, Pine Hall. 
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The following deck set up may be used for this program. 


// Job Card 

//3@BLIB 4 DD A DSNAME=SYS2 . LP, UNIT=2314 , DISP=($LD, PASS) , VOLUME=SER=SYS06 
//STEP1 4 EXEC A LPSYS 

//COMP.SYSIN A DD A * 


MPS Program 


/* 


//GO.SYSIN 4 DD A * 


Data 


/* 
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6.4.4 Continuous System Modeling Program (CSMP) 


IBM's Continuous System Modeling Program (CSMP) is a problem-oriented 

program designed to facilitate the simulation of continuous processes. 
on the 360. The program provides an application-oriented language that 
allows these problems to be prepared directly and simply from either a 


block-diagram representation or a set of ordinary differential equations. 


Typical applications might be a control engineer's study of the effec- 
tiveness of various control system designs, a physiologist's simulation 
of the cardio-vascular system, and a mechanical engineer's investigation 


of the effects of damping and backlash in a proposed mechanical device. 


The following is a sample deck set-up for CSMP programs: 


// Job Cara 
//3@BLIB DD DSNAME=SYS2,PRAGLIB, DISP=(@LD, PASS) 
//STEPl1 EXEC CSMPL 
//CSMPL.SYSIN DD * 
Data cards for CSMP 
ENDJGB 


/* 


Documentation: 


1. 8/360 Continuous System Modeling Program Application Descrip~ 
tion (Form No. H20-02k0). 


2. 8/360 Continuous System Modeling Program User's Manual, 


(Form No. H20-0367). 
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The Physics Application program, TRANSPORT, calculates the properties 


of particles in a beam traveling through a magnetic deflection system. 


The following is a sample 
// Job Card 


deck set-up for TRANSPORT programs: 


//J$BLIB DD DSNAME=SYS2. PRAGLIB, DISP=( ALD, PASS) 


//STEPlL EXEC 
//FTO4FOO1L DD 
//FTO6FOOL DD 
//FTO5FOOl DD 


Data cards 


/* 


PGM=TRNSP@RT 

UNIT=SYSCP, DCB=(RECFM=F, BLKSIZEE=80) 
SYSPUT=A 

* 


for Transport 


Documentation for this program is available from the Systems Documen- 


tation Office. 
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6.4.6 General Purpose System Simulator/360 (GPSS/360) 


IBM's General Purpose System Simulator/360 is suitable for modeling 
and examining the behavior of systems in the engineering, management. 
science, and computer systems areas. GPss/360 is a significant ex- 
tension of the GPSS IIT language on the 7090. 


There are several IBM manuals available for this system. 


H20-0186 GPSS/360 Application Description 
H20-0304, | GPSS/360 Introductory User's Manual 
H20-0326 GPSS/360 User's Manual 


The documentation is available from the Systems Documentation Office, 
Room 185, Pine Hall. 


The following is a sample deck setup for GPSS users. 


// Job Card . 
//JOBLIB A DD A DSNAME=SYS2 . PROGLIB , DISP=(@LD, PASS) 
//NOW O EXEC A PGM=DAGO1, PARM=C 

//DPUTPUT A DD A SYssuT=A 

//DINTERS A DD A DSNAME=SYS1.UTL,DISP=6LD 
//DSYMTAB A DD A DSNAME=SYS1 .UT2 , DISP=6LD 
//DREPTGEN A DD A DSNAME=SYS1.UT3,DISP=6LD - 
//DINTWORK A DD A DSNAME=SYS1.UT4 , DISP=$LD 
//DINPUT1 A DD A * 


GPSS Problem Formulation 
/* 


Note: The symbol "A" indicates one or more blanks. 
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6.4.7 NWAY 


NWAY is a tabulation and statistical processing program for social sci- 
ence research. It is a general statistical program with the following 
special features: 


o A mixture of different computation can be requested at one 
time and will be executed, to the extent of storage facilities 
available on the computer, in the same pass through the user's 
data. 


o Storage in the computer is dynamically allocated by the program 
so that the user rarely need be concerned with the storage re- 
quirements of the tasks that he requests. 


Oo The program is designed to be as efficient as possible in the 
handling of large data files. This feature makes it feasible 
to perform analyses on such large bodies of data as population 
censuses. 


Oo The user is given control of the data input, enabling the use 
of any kind of transgenerative or recoding process desired. 


Oo The program can Simultaneously perform calculations on different 
units of data. For example, the program could, on a single pass 
of a population census file, perform analyses of both variables 
measured on individuals and on variables measured on their 
households. 


Oo Facilities are provided for the labeling of both variables and 
categories within variables (i.e., values of the variable). 


Oo NWAY is written in an elementary subset of FORTRAN IV, and 
should be readily adaptable to most FORTRAN IV processors. 
Its current implementation is in OS/360 FORTRAN IV (H). 
NWAY may be executed using a catalogued procedure. The following job 


control is required for execution: 


// Job Card 

//S@BLIB DD DSNAME=SYS2 . PROGLIB, DISP=@LD 
// EXEC NWAY 

//GO.SYSIN DD * 


NWAY input: includes parm cards, vars and varl cards, format 
cards, data, etc. 


/* 
(NOTE: If your data is not on cards but on a disk or tape data set, 
an additional DD card defining the data set is required for 
the GO step.) 
Documentation for NWAY is available from the Systems Documentation Office, 
Room 185, Pine Hall, for $1.00. 
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6.4.8 MDSCAL 


“MDSCAL is a multi-dimensional scaling program written by Joseph Kruskal, 
Bell Telephone Laboratories. It has been converted to FORTRAN IV (Level 
H) and is available in the applications program library, SYS2.PROGLIB. 


Multi-dimensional scaling is a statistical technique for cluster analysis. 
It constructs a configuration of points in space from information about 
the distance between the points. A wide variety of options is available. 
For example, the data may be in the form of either an entire matrix or a 
lower halfmatrix. The matrix need not be symmetric, and the diagonal 

may be absent. Either similarities or dissimilarities are acceptable, 
replicated measurements are permitted, data values may be missing, and 
weighting is available. A maximum of 60 objects may be scaled in up 


to 10 dimensions, with a maximum of 1800 data values. 


MDSCAL documentation is available from the Systems Documentation Office, 
Room 185, Pine Hall, for $1.75. 
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6.5 IBM CATALOG OF PROGRAMS 
6.5.1. Introduction 


Another source of programs available tc the user are those iisted in 
the document Catalog of Programs for IBM/36C. (Form No. 720-1619;. 


This publication is available for reference in the Systems Dozumentation 
Office, Room 185, Pine Hali, Ext. 4877. 


The publication lists four types of available programs: 


Type I 
Programming Systems: Programs conceived and developed by IBM as 
integral parts of. the data processing system for which they are 


written. 


Type IT 
Application Programs: Carefuily se.seted sclutions by IBM cf data 
processing problems. They are supported by well planned documen- 


taticn and tested procedures. 


Type ITT 
IBM-Contriouted Programs: Programs contributed by IBM employees 


to aid the programming and system community. 


Type IV 
Customer Contributed Programs: Aids to the programming community 
supplied by members of customer organizations and individual users 


of TBM Data Prozessing Systems. 


6.5.2 How to Obtain a Program 


Users interested in obtaining a copy of a program listed in the Catalog 
of Prcegrams may do so through the Systems Decumentation Cffizz. If the 
program requested is distributed on magnetic tape, the user will be re- 
quired to supply the tape. Programs of this type take about three weeks 


for delivery. 
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6.6 SLAC Computer Program Library 


6.6.1 Introduction 


This program library sérves the needs of the SLAC Facility for programs 
from the fields of physics applications, graphics and picture processing 
as well as an archive to document and distribute programs referenced in 
SLAC publications; systems programs used only at SLAC are also included. 
The library is meant to supplement the Stanford Extrinsic Program Library 
described in Section 6.2 of this manual, and is less formal in its 
acceptance requirements, documentation and management. A list of the 


entries in the SLAC library is included in this section. 


6.6.2 Documentation 


Program submittal forms, write-ups, distribution decks, and other in- 
formation may be obtained from the SLAC program librarian, 
Linda Lorenzetti at SIAC, Ext. 8689. 


A KWIC index of the SLAC library is also available for reference in the 
Systems Documentation Office, Room 185, Pine Hall, Ext. 4877. 
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6.6.3 Available Programs 


Each program entry includes the following information: 


Addd(SC.L) Descriptive Title with Keywords. (subroutine names) 
Machine and language 


where 
Addd is the SLAC program library number 
sc is the SHARE Classification code 
€-g-, JD Output - plotting 
L is the language code, 
A = BD500 ALGOL 
F = IBM/090 FORTRAN ITI 
G = IBM/7090 FORTRAN IV 
H = IBM360 FORTRAN Iv (H) 
M = IBM360 Assembler Language Macro 
S = IBM/090 SURALGOL 
Z = Miscellaneous 


AOOL(J5.S) GRAPH (CURVE-PLOTTING) AND CONTOUR OF FUNCTIONS ON THE 
CALCOMP PLOTTER. (AXAS,GRAPH,SKALE, CONTOUR) 7090 SUBALGOL, 
i PROCEDURES 


A002(S15.S) ERROR-FUNCTION BY HASTING'S APPROXIMATION. (ERF) 7090 
SUBALGOL PROCEDURE 


AOO3{M1-S) | LEXICOGRAPHIC ORDRRING OF THE ROWS OF A MATRIX. (ORDER ) 
7090 SUBALGOL PROCEDURE 


AOOK(T1.F) | MAGNETIC-FIELD CALCULATION FOR AN AIR-GAP COIL. (COILB) 
7090 FORTRAN II PROGRAM 


AOO5(E1.S) QUADRATIC-FORM CONTOURS CALCULATION. (EPOINTS) 7090 SUBALGOI, 
PROCEDURE 


AOO6(F4.S)  LEAST-SQUARES FITTING OF FUNCTIONS TO MEASURED DATA. (CURVE) 
7090 SUBALGOL PROGRAM 


AOQO7"T1.S) TRANSPORT: A PROGRAM TO SOLVE 1ST AND @ND ORDER BEAM-TRANS- 
PORT OPTIC PROBLEMS. (TRANSPORT ) IBM7090 SUBALGOL AND 
FORTRAN IV AND IBM360 FORTRAN IV (H) 


AOO8(J4.A)  BASIC-ALGOL: OUTPUT PROCEDURES FOR ALGOL. (TAB, TAB1,HEAD, 
PRINT, LINEQ, INTEGRAL, LEBESQUE) B5500 AIGOL PROCEDURES 


A009(J5.A)  CURVE-PLOTTING (GRAPH-PROCEDURES) ON THE CALCOMP PLOTTER. 
(POINT, CURVE, TITLE,GRAPH) B5500 ALGOL PROCEDURES 
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AO10(T1.A) 
‘ao1u(12.4) 
A012(G5.A) 
AO13(T .A) 
Ao14(T1.A) 
AO15(M1.A) 
AO16(J5.A) 
AO17(E5.A) 
AO18(Z .A) 
Ao019(D1.A) 
Ao20(J5.A) 
Aoel(T .A) 
A022(F4.A) 
A023(T .A) 
Aoek(T .A) 
A025(J4.H) 


A026(D1.A) 
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CALCULATION OF AXIAL MAGNETIC-FIELD FROM SOLENOIDS AND IRON 
RINGS ALONG THE FIELD AXIS. (IRONSUM,COILSUM) B5500 AIGOL 


CALCULATION OF MAGNETIC-FIELD FROM SOLENOIDS AND TRON AT 
ANY POINT IN SPACE. (MARKIV) B5500 ALGOL PROGRAM 
UNIFORM AND NORMAL RANDOM-NUMBER GENERATORS. (SETUPRANDOM, 
RANDOM, NORMAL) B5500 ALGOL PROCEDURES 


CALCULATION OF DEFLECTION, MOMENT, AND MAXIMUM BENDING - 
STRESS OF AN END-SUPPORTED-BEAM. B5500 AIGOL PROGRAM 


BEAM-TRACE THROUGH A SYSTEM OF MAGNETIC-LENS ELEMENTS. 
(BEAMTRACE) B5500 AIGOL PROGRAM 


SORT AND SHUFFLE THE ROWS OF AN ARRAY. (SORT, SHUFFLE) 


B5500 AIGOL PROCEDURES 


CURVE-PLOTTING USING THE LINE-PRINTER, (OUTPLOT) B5500 


AIGOL PROCEDURE 


MINIMIZE A FUNCTION OF ONE VARIABLE. (MINIMIZE’ B5500 
AIGOL PROCEDURE 


PRINT THE CALENDAR FOR ANY YEAR BC OR AD (CALENDAR) B5500 | 


‘ -AIGOL PROGRAM 


NUMERICAL INTEGRATION BY ADAPTIVE SIMPSON'S-RULE. 
B5500 AIGOL PROCEDURE 


(SIMPS5 ) 


CONTOUR PLOT OF A FUNCTION OF TWO VARIABLES ON THE CALCOMP 
PLOTTER. (CONTOUR B5500 AIGOL PROCEDURE 


PROGRAM FOR VARIABLE PERMEABILITY MAGNETOSTATIC-FIELD 
PROBLEMS. (NUTCRACKER) B5500 AIGOL PROGRAM 
NONLINEAR LEAST-SQUARES WITH CONSTRAINTS. (SOLVE) B5500 
AIGOL PROCEDURE 


THICK TARGET, HIGH ENERGY BREMSSTRAHLUNG. . B5500 ALGOL PROGRAM 


HIGH ENERGY SECONDARY-PARTICLE PHOTOPRODUCTION CALCULATION 
FOR SLAC-USER'S-HANDBOOK, (FIVE PROGRAMS) B5500 ALGOL 
PROGRAMS 


2250-SCOPE OUTPUT FOR BPS FORTRAN. (STTSCP,RSETUP,AXES ,ETC. ) 
IBM360 FORTRAN SUBROUTINES : 


NUMERICAL INTEGRATION BY RECURSION. (SIMPS6) 35500 ALGOL 


PROCEDURE 
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A027(Q1.H) 
A028(M4.H) 
A029(M.H) 


A030(R1.H) 


AQ31(M2.H) | 


A032(Al.H) 
A033(A1.H) 
A034(M2.H) 


A035 (J9.M) 
A036(19.M). 
A037(T .A) 


A038(M5.H) 
A039(19.H) 


AO4O(T5.F) 
AO41(L7.A) 
Aok42(Q1.H) 


A043 (J9.H) 


AOLL(J9.H) 
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READ INTERVAL TIMER AND CONVERT TO MILLISECONDS, (TIM1) 
IEM360 FORTRAN SUBROUTINE 

SHIFT-OPERATIONS FOR FULLWORD OPERANDS, (SHF1 :SHF1RA ,SHP1LA, 
SHF1RL ,SHFLLL,SHF1RC ,SHF1LC) IBM360 FORTRAN SUBROUTINES 
SHIFT-OPERATIONS FOR DOUBLEWORD OPERANDS. _ (SHF2:SHFOR, 
SHF2L) IBM360 FORTRAN SUBROUTINES 

LOGICAL-OPERATIONS ON FULLWORD OPERANDS. (IGO1:I1GOMAN, 


IGOLOR,IGO1XR,IGO1CM) IBM360 FORTRAN SUBROUTINES 


HEXADECIMAL TO EBCDIC CONVERSION, 
SUBROUTINE 


(HEX1) IBM360 FORTRAN 


GREATEST-COMMON-DIVISOR. (GCD1) IBM360 FORTRAN SUBROUTINE 


NEXT PRIME-NUMBER). (XP1) IBM360 FORTRAN SUBROUTINE 


FORTRAN MOVE-A-CHARACTER ROUTINE. (VC1) IBM360 FORTRAN 
SUBROUTINE 


PRINTOUT-MACRO INSTRUCTION FOR SIMPLE OUTPUT AND DEBUGGING. 
(PRINTOUT) IBM360 ASSEMBLER LANGUAGE 


READCARD-MACRO INSTRUCTION FOR SIMPLE INPUT. 
IBM360 ASSEMBLER LANGUAGE 


(READCARD ) 
BREMSSTRAHLUNG TABLES FOR POSITRON-HYDROGEN ATOM COLLISION, 
B5500 AIGOL PROGRAM | 

BINARY SEARCH-FUNCTION. (IBS) IBM360 FORTRAN SUBROUTINE 


FORTRAN INTERNAL INPUT/OUTPUT BUFFER-CONTROL, (F10999, 
F1099X) IBM360 FORTRAN SUBROUTINES 


DIREC-GAMMA-MATRIX TRACE REDUCTION PROGRAM. (FTRACE ,GLEANE, 
TALKER , CHODED )' IBM7090 MAP AND FORTRAN IV PROGRAM 


EXTENDED ALGOL-TO-FORTRAN TRANSLATOR, 
AIGOL’ PROGRAM 


(ALTRAN/1 85500 


ABNORMAL-END PROGRAM TERMINATOR, (ABD1) IBM360 FORTRAN 
SUBROUTINE 
PROGRAMMED CHARACTER-GENERATOR FOR 2250-SCOPE OUTPUT-BUFFER, 
BCDVE1 ,BCDVE2,BCDVE3 ) IBM360 FORTRAN IV AND ASSEMBLER LANGUAGE 
SUBROUTINES 


INPUT/OUTPUT INTERFACE FOR 2250-SCOPE. 


(CRTIOA ,CRTIOB) 
TBM360 FORTRAN SUBROUTINES ) | 
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A045(J9.H) 
AO46(Al.H) 
AO47(A1.H) 
Aok8(M2.H) 
AokO(T .S) 
A050(J9.H) 
A051(Q .H) 
Ao52(Q .H) 


A053(J9.H) 
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EXPAND AND TRANSLATE GRAPHIC-ELEMENTS FOR THE IBM 2250-SCOPE. 
(ZOOM1,EXPND1) IBM360 FORTRAN SUBROUTINES 


DOUBLE PRECISION PRODUCT-ACCUMULATION WITH OPTIONAL ROWUNDING. 
(DPRIR,DPRIU) IBM360 FORTRAN SUBROUTINES 


-PRODUCT-ACCUMULATION FOR SHORT AND LONG FLOATING -POINT 


OPERANDS. (DPR2) IBM360 FORTRAN SUBROUTINES 


HEXADECIMAL TO EBCDIC CONVERSION ROUTINE. (HEX2) IBM360 
FORTRAN SUBROUTINE 


POISSON-EQUATION SOLVING PROGRAM. IBM 709C SUBAIGOL PROGRAM 
FORTRAN INTERFACE SUBROUTINES FOR BUFFERED IBM2250-SCOPE 
MOD 1 INPUT/OUTPUT. (GRDBUF ,GRDSTR,ETC. ) IBM360 FORT 
SUBROUTINES 


UTILIZATION OF AVAILABLE-MEMORY WITH FORTRAN PROGRAMS, 
(#AVAIIM) IBM360 SORTRAN SUBROUTINES 


SUBROUTINE TO RELEASE-A-PARTITION UNDER 08/360 VIA THE 
WAITR MACRO. (WAITR) IBM360 FORTRAN SUBROUTINE 


SUBROUTINE TO SET THE BUFFER-SWITCH ON THE IBM 2250-SCOPE 
MOD 1. (SETBUF) IBM360 FORTRAN SUBROUTINE 
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APPENDIX A: GLOSSARY 


access method: Any of the data management techniques available to the 
user for transferring data between main storage and an input/output 
device. 


alias: An alternate name that may be used to refer to a’ member of a 
partitioned data set; an alternate entry point at which execution of a 
program can begin. 


allocate: To grant a resource to, or reserve it for, a job or task. 


attribute: <A characteristic; e.g., attributes of data include record 
length, record format, data set name, associated device type and volume 
identification, use, creation date, etc. 


auxiliary storage: Data storage other than main storage. 


basic access method: Any access method in which each input/output 
statement causes a corresponding machine input/output operation to 
occur. (The primary macro instructions used are READ and WRITE. ) 


batch processing: (See stacked job processing. ) 
block (records): 


1. To group records for the purpose of conserving storage space or 
increasing the efficiency of access or processing. 

2. A physical record so constituted, or a portion of a telecommunications 
message defined to be a unit of data transmission. 


buffer rogram input/output): A portion of main storage into which 
data is read, or from which it is written. 


cataloged procedure: A set of job control statements that has been 
placed in a special data set named SYS1.PROCLIB and that can be retrieved 
by naming it in an execute (EXEC) statement. 


concatenated data set: A collection of logically connected data sets. 
Concatenation is a fancy word for joining collections of information 
(i.e. data sets, libraries) end-to-end. 


control block: A storage area through which a particular type of 
information required for control of the operating system is communicated 
among its part. 


control program: A collective or general term for all routines in the 
operating system that contribute to the management of resources, implement 
the data organization or communications conventions of the operations. 

CPU (central processing unit): The unit of a system that contains the 
circuits that control and perform the execution of instructions. 
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data control block: A control block through which the information required 
by access routines to store and retrieve data is communicated to them. 


data definition name (ddname): A name appearing in the data control 
block of a program which corresponds to the name field of a data definition 
statement. 


data definition (DD) statement: A job control statement that describes a 


data set associated with a particular job step. 


data management: A general term that collectively describes those functions 
of the control program that provide access to data sets, enforce data 
storage conventions, and regulate the use of input/output devices. 


data set: The major unit of data storage and retrieval in the operating 
system, consisting of a collection of data in one of several prescribed 
arrangements and described by control information that is accessible by 
the system. 


data set control block: (DSCB): A data set label for a data set in 


directeaccess storage. 


data set label (DSL): A collection of information that describes the 
attributes of a data set, and that is normally stored with the data set; 
a general term for data set control blocks and tape data set labels. 


device-independence: The ability to command: input/output operations 
without regard to the characteristics of the input/output devices. 


device name: Usually, the general name for a kind of device, specified at 
the time the system is generated. For example, 2311 or 2400 or TAPE. 


direct access: Retrieval or storage of data by a reference to its location 
on a volume, rather than relative to the previously retrieved or stored 
data. 


dump (main storage): - 
1. To copy the contents of all or part of main storage onto an output. 
device, so that it can be examined. 
2. The data resulting from l. 
3. A routine that will accomplish 1. 


entry point: Any location in a program to which control can be passed 
by another program. 


execute (EXEC) statement: A job control statement that designates a job 
step by identifying the load module or cataloged procedure to be fetched 
and executed. 


input stream: The sequence of control statements and data submitted to 
the operating system on an input unit especially activated for this purpose 
by the operator. 
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job: A total processing application comprising one or more related 
processing programs, such as a weekly payroll, a day's business ; 
transactions, or the reduction of a collection of test data. 


job control statement: Any one of the control statements in the input 
job stream that identifies a job or defines its requirements. 


job library: A concatenation of user-identified partitioned data sets 
used as the primary Source of load modules for a given job. 


job_management: A general term that collectively describes the functions 
of the job scheduler and master scheduler. 


job _ processing: The reading of control statements from an input stream, 
the initiating of job steps defined in these statements, and the writing 
of SYSOUT messages. 


job scheduler: The control program function that controls input job 
streams and system output, obtains input/output resources for jobs and 

job steps, attaches tasks corresponding to job steps, and otherwise 
regulates the use of the computing system by jobs. (See reader/ interpreter, 
initiator/terminator, output writer. ) 


job (JOB) statement: The control statement in the input job stream that 
identifies the beginning of 4 series of job control statements for a 
Single job. 


job_ step: That unit of work associated with one processing program and 
related data. A cataloged procedure can comprise many job steps. 


language translator: A general term for any assembler, compiler, or other 
routine that accepts statements in one language and produces equivalent 
statements in another language. 


library: 

1. In general, a collection of objects (e.g., data sets, volumes, card 
decks) associated with a particular use, and the location of which 
is identified in a directory of some type. In this context, see job 
library, link library, system library. 

2. Any partitioned data set. 


_ link library: A generally accessible partitioned data set which, unless 
otherwise specified, is used in fetching load modules referred to in 
execute (EXEC) statements and in ATTACH, LINK, LOAD, and transfer control 
(XCTL) macro instructions. 


linkage: The means by which communication is effected between two routines 
or modules. 


linkage editor: A program that produces a load module by transforming 
object modules into a format that is acceptable to fetch; combining 
separately produced object modules and previously processed load modules 
into a single load module; resolving symbolic cross references among them; 
replacing, deleting, and adding control sections automatically on request; 
and providing overlay facilities for modules requesting them. 


load: To fetch, i.e., to read a load module into main storage preparatory 
to executing it. 


load module: The output of the linkage editor; a program in a format 
suitable for loading into main storage for execution. 


logical record: A record from the standpoint of its content, function, 
and use, rather than its physical attributes; i.e., one that is defined 
in terms of the information it contains. 


macro instruction: A general term used to collectively describe a macro 
instruction statement, the corresponding macro instruction definition, 

the resulting assembler language statements, and the machine language 
instructions and other data produced from the assembler language statements; 
loosely, any one of these representations of a machine language instruction 
sequence, 


main storage: All addressable storage from which instructions can be 
executed or from which data can be loaded directly into registers. 


master scheduler: The control program function that responds to operator 
commands, initiates actions requested thereby, and returns requested or 
required information; thus, the overriding medium for controlling the use 
of the computing system. 


module (programming): The input to, or output from a single execution of 
an assembler, compiler, or linkage editor; a source, object, or load module; 
hence, a program unit that is discrete and identifiable with respect to 
compiling, combining with other units, and loading. 


multiprogramming: A general term that expresses use of the computing system 
to fulfill two or more different requirements concurrently. 


name: A 1- to 8-character alphameric term that identifies a data set, a 
control statement, a program, or a cataloged procedure. The first 
character of the name must be alphabetic. 


object module: The output of a single execution of an assembler or compiler, 
which constitutes input to the linkage editor. An object module consists 

of one or more control sections in relocatable, though not executable, form 
and an associated control dictionary. 


operator command: A statement to the control program, issued via a console 
device, which causes the control program to provide requested information, 
alter normal operations, initiate new operations, or terminate existing 
operations. 
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partitioned data set: Independent groups of sequentially organized data 
sets, each identified by a member name in the directory. 


physical record: A record from the standpoint of the manner of form in 
which it is stored, retrieved, and moved; i.e., one that is defined in 
terms of physical qualities. 


private library (of a job step): Any partitioned data set which is neither 


the link library nor any part of the job library. 


problem program: Any of the class of routines that perform processing 

of the type for which a computing system is intended, and including 
routines that solve problems, monitor and control industrial processes, 
sort and merge records, perform computation, process transactions against 
stored records, etc. 


processing program: Ary program capable of operating in the problem 
program mode. This includes IBM-distributed language processors, application 
programs, service and utility programs, and user-written programs. 


qualified name: A control statement term that comprises one or more names, 
each qualifying the name that follows it. Levels of qualification are 
separated by periods. For example, the term stepname.procstepname represents 
a@ procedure step name qualified by a job step name. 


record: A general term for any unit of data that is distinct from all 
others when considered in a particular context. 


reenterable: The attribute of a load module that allows the same copy 
of the load module to be used concurrently by two or more tasks. 


resource: Any facility of the computing system or operating system 
required by a job or task and including main storage, input/output devices, 
the central processing unit, data sets, and control and processing programs. 


secondary storege: Auxiliary storage. 
segment: 


1. The smallest functional unit (one or more control sections) that can 

be loaded as cne logical entity during execution of an overlay program, 
2. As applied to telecommunications, a portion of a message that can be 
contained in a buffer of specified size. 


service program: Any of the class of standard routines that assist in the 
use of a computing system and in the successful execution of problem 
programs, without contributing directly to ccntrol cf the system or 
production of results, and including utilities, simulators, test and 
debugging routines, etc. 


source module: A series of statements (in the symbolic language of an 
assembler or compiler) which constitutes the entire input to a single 
execution of the assembler or compiler. 
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supervisor: As applied to the operating system, a routine or routines 
executed in response to a requirement for altering or interrupting the 
flow of operations through the central processing unit, or for performance 
of input/output operations, and, therefore, the medium through which the 
use of resources is coordinated and the flow of operations through the 
central processing unit is maintained; hence, a control routine that is 
executed in supervisor state. 


SYSIN: A name conventionally used as the data definition name of a 
data set in the input job stream. 


SYSOUT: An indicator used in data definition statements to signify that 
a data set is to be written on a system output unit. 


system library: The collection of all cataloged data sets at an installation. 


SYS1.LINKLIB: The partitioned data set that contains the IBM-supplied 
processing programs and part of the nonresident portion of the control 
program. It may also contain user-written programs. 


SYS1.PROCLIB: The partitioned data set that contains cataloged procedures. 


task: A unit of work for the central processing unit from the standpoint 
of the control program; therefore, the basic multiprogramming unit under 
the control program, 


task management: A general term that collectively describes those 
functions of the control program that regulate the use by tasks of the 
central processing unit and other resources (except for input/output devices). 


telecommunications: A general term expressing data transmission between 
a computing system and remotely located devices via a unit that performs 
the necessary format conversion and controls the rate of transmission. 


teleprocessing: A term associated with IBM telecommunications equipment 
and systems. 


turn-around time: The elapsed time between submission of a job to a 
computing center and the return of results. 


user: Anyone who requires the services of a computing system. 

é 
volume: <All that portion of a single unit of storage media which is 
accessible to a single read/write mechanism. 
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PREFACE 


This second edition of the WYLBUR users manual updates 
the first edition to reflect the new features which have 
been added to WYLBUR since its introduction to the Stanford 
University Community. The developers of the WYLBUR system 
wish to offer their thanks to the early users who suffered 
through the many system crashes which occurred while 
producing the stable system enjoyed today. 


WYLBUR was produced by the programming staff of the 
Stanford Computation Center, Campus Facility. Credits are 
due all of the Staff of the Campus Facility without whose 
Individual efforts WYLBUR could not have been born or 
reached its young manhood. Warranting particular mention 
are Roger Fajman, John Borgelt, John Gilman, Leighton 
Allen, Janet Gallo, Jim Moore and Bill Riddle upon whose 
shoulders the bulk of the design, implementation, and 
documentation fell. We also wish to expess a special word 
of thanks to the Director of the Stanford Computation 
Center, Professor E. A. Feigenbaum, for his support during 
the development of the system. 


WYLBUR is a subsystem residing under what is called the 
Stanford Terminal Processor (STP) and is the first of many 
terminal oriented facilities we hope to develop. here at 
Stanford. 


The design goal was to produce a terminal oriented text 
editor and remote job entry facility with fairly strong 
data management facilities to be used as an aid in program 
development. WYLBUR is not a_ time sharing facility in the 
sense that that word means interactive computation. It is, 
however, a system which provides quick response’ to many 
users simultaneously sitting at terminals doing text 
editing. 


Additional power is provided through the integration of 
STP with HASP which is the spooling submonitor used to 
control the batch services here at Stanford. Modification 
to this piece of work provides for the low overhead 
introduction of programs into the batch stream, in an easy 
and natural way, from the WYLBUR- terminal. Output from 
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batch stream programs can be left on disk for later review 
from the terminal. While this does not’ provide time 
sharing fn the formal sense, it does’ provide a more 
favorable facility for getting work done than’ that which 
can be provided by a batch system alone. 


Rod Fredrickson 

Associate Director, 

Stanford Computation Center, 
Campus Facility 


W_Y U 
Stanford University 
Computation Center 

Text Editor 


by William £—. Riddle 


WYLBUR is a Text Editor designed to operate in either 
an O/S or HASP environment in order’ to provide users at 
2741 terminals a comprehensive text editing facility with 
prompt response, while otherwise allowing the computer to 
proceed with processing of the normal batch job stream. 

WYLBUR allows the user to change the contents of a line 
without retyping all of it, to insert, delete or replace 
lines, to copy and move lines, to renumber’ lines, and to 
list lines. In addition, the user may retrieve external 
data sets in order to work upon them and save data sets 
which have been constructed. The user may also insert the 
data set into the monitor's input stream for processing as 
a batch job. 

This manual is intended to serve a dual purpose. First 
it. should serve as a planning guide for potential users oe 
an introduction to what the user can and cannot accomplish 
using WYLBUR. Second, it should serve the user while he is 
Operating WYLBUR -- a reference text. 


The format of the manual Is as follows. In order to 
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make the later discussion more readable, the definitions of 
all terms are gathered Into an initial section. The 
remaining sections Introduce the WYLBUR commands in order 
of thelr Increasing difficulty. In introducing . the 
commands, the form of the manual is conversational with 
examples given showing what will happen during a session 
with WYLBUR when the command under discussion is used. In 
the examples, all material. which is typed at the terminal 
by WYLBUR Is underlined to differentiate it from the typing 
done by bbe: user. Also, the typing of the non-printing 
keys ATTN and RETURN are designated by ATTN and CR. 


DEFINITION OF BASIC TERMS 

Before outlining the set of operations which is 
avallable in WYLBUR, it is necessary to define some basic 
terms which will be needed in the discussion. 

The elementary “atomic unit" from which all data sets 
are ultimately derived is the CHARACTER. The set of valid 
WYLBUR characters ~ the WYLBUR CHARACTER SET - consists of 
those on the keyboard of an IBM 2741 teletypewriter, a 
picture of whitch appears In Appendix A. This Is a standard 
typewriter keyboard with a few special purpose keys, the 
function of which will be explained shortly, added. 

The 2741 contains some characters which are not 
avallable on the 1403 high speed printers, ! and ¢ These 
extra characters will be printed as the blank character 


when a WYLBUR created data set Is printed on the 1403. 


On a 2741 keyboard there is also a set of keys which do 
not cause any printing to occur. These include the 
special-purpose keys which were mentioned previously. Some 
of these have a special meaning when used under WYLBUR and 


hence a. full description of their function is deferred 


until the WYLBUR commands are explained. However, a rough 


description of the function of these NON-TYPING KEYS is 
given now In order to complete the discussion of the WYLBUR 
character set. 


RETURN = this key returns’ the printing 
head to the left-hand margin. in WYLBUR it 
is used during a session to signal that the 
user has finished typing a line and wishes 
WYLBUR. to inspect the line and effect any 
operations which are called for. 

BACK-SPACE <= this key moves the printing 
head one space to the teft. In WYLBUR this 
effectively erases. this character from the 
line of text which the user is currently 


typing. 
TAB ~ this moves the print head forward 
to the next tab setting. The user must 


follow a set of very rigid rules, which will 
be explained subsequently, concerning its 
use, 

CLR and SET toggle switch ~ this is used 
to clear and set the tabs. There are also 
rigid rules concerning the use of this switch 
which will] be explained below. 

MAR REL = margin release key used as on a 
standard. typewriter. This key serves no 
purpose whatsoever in WYLBUR. 

SHIFT and LOCK - used to shift into upper 
case as ona standard typewriter. 

ON and OFF toggle switch - since the 2741 
is basically an electric typewriter, this 
switch serves the function of turning on and 
off the terminal. it should not be used 
during a WYLBUR session since’ the results 
might be disastrous. 7 

ATTN - used during a session to tell 
WYLBUR that it should suspend whatever it is 
currently doing for the user and prepare to 
accept a new directive. 


It should be reiterated that the above explanation of the 
RETURN, ATTN, and BACK=SPACE keys is inadequate for a full 
understanding of their function in WYLBUR. The full story 
on the use of these keys will unfold as the varfous WYLBUR 
commands are explained, and then be brought together in a 
succint outline In the appendix, 2 

Characters, the elementary building blocks, are used to 
construct the following increasing hierarchy of forms. | 

Character String - any group of 
consecutive characters which occurs on one 
line, 
Line - a character string which begins at 
the left margin and ends with a carriage 
return. ; 
Range - a group of lines, each of which 
possesses some distinguishing characteristic. 
Data Set - a group of lines which, taken 
as a whole, forms some logical unit of 
interest. 
The rest of this section is devoted to a fuller description 
of each of these constructs, their forms and attributes, 
and their functions in WYLBUR, 

CHARACTER STRINGS are the basic unit of interest in 
WYLBUR since it fs these entities which a WYLBUR user 
generally wishes to manipulate. A. character string jis 
represented by a group (of at least one) of consecutive 
characters from the WYLBUR character set. Blanks are 
significant - a group of three (say) blanks appears In the 
String as three blank characters. The significance of 


blanks also applies to leading (those before any other 


characters in the string) and terminal (those following all 


other characters in the string) blanks. 

A LINE f{s a special character string which begins at 
the leftshand margin and continues to a carriage return, 
It is also differentiated from a normal character string In 
that it forms a logical unit. Two types of lines may be 
distinguished by the type of logical unit they form. The 
first Is a COMMAND LINE which has the following format 

<WYLBUR REQUEST> <USER RESPONSE> CR 
Essentially, WYLBUR asks the user a question by typing the 
<WYLBUR REQUEST> prompt at the user's terminal. Then the 
user completes the line by typing his <USER RESPONSE> 
answer. As an example, WYLBUR may ask the user a question 
and then, on the next line, prompt the user for an answer 
to the question that has been posed 

REPLY? 
The user answers by completing the line with his answer and 
then finishing the line with a carriage return 

REPLY ? YES CR 

The second type of line is a LINE OF TEXT -- a logical 
unit from the data set which the user is working on with 
WYLBUR's help. The general form of this type of line is 

“LINE NUMBER> <SINGLE BLANK> <CONTENT STRING> CR 
The <LINE NUMBER> is an attribute of the line, used by 
WYLBUR to determine the position of the line relative to 
the rest of the lines in the data set. For example, all 
lines before a line with line Hiner seven will have a line 


number less than seven and all] lines following that line 


will be numbered greater than seven. A line number is a 
mixed decimal number with four integer digits and three 
decimal digits 

0013.098 9999.999 0065.100 
Leading zeros may be dropped so that 

0013,098 and 13.098 


are equivalent. Terminal zeros may also be dropped so that 


0065.100 and 65.1 
are equivalent. Embedded blanks are not equivalent to 
zeros so that 

6 5. 1 and 605.01 
are not equivalent, More comments will be made concerning 
blanks within line numbers when the <SINGLE SPACED is 
discussed below. If the Ifne number Is an Integer, the 
decimal point need not be typed so that 

0098.000, 98.0, 98., and 98 
are all equivalent. 

The second major part of a line of text Is the <CONTENT 
STRING> (or simply content) of the line, This may be a 
string of from 0 to 133 consecutive characters. lf no 
characters are present, then the line is a line of blanks. 
It may be useful to the user to have WYLBUR monitor the 


number of characters which are contained In the content of 


a line. Consider, for example, the construction of a data 


set which is a Fortran program. Since a maximum of 72 


characters may be In any line, it Is useful to the user to 


know when he has typed more than that number of characters 
in a line. For this reason, WYLBUR recognizes an attribute 
of Vines called LENGTH - a count of the number of 
characters in the line, up to and including the fast 
non-blank character. This attribute is assumed by WYLBUR 
to have a value of 72 unless the user takes definitive 
action (by using the SET command described below) to change 
it to some other value. When a line with more than the 
designated number of characters is typed, WYLBUR will warn 
the user that he has exceeded the limit which has been set. 
The line will still be accepted by WYLBUR and placed in its 
appropriate place in the data set -- the message that 
WYLBUR sends is a warning only. The user must change the 
line so that {ft conforms to the length which he desires. 
Note that LENGTH is only an attribute of the contents of a 
line - the characters used for the line number are not 
included in the length of a line. 

The remaining part of a line of text is the <SINGLE 
BLANK>. This is used by WYLBUR- to recognize the dividing 
point between the line number and the content of the line. 


Hence anything appearing before the blank is interpreted as 


a line number and anything after the blank is considered. 


part of the content of the line. If three (say) blanks 
follow the line number, WYLBUR will use the first as a 
signal for the end of the line number and the ‘next two 
blanks will cause the content of the line to begin with two 


blank characters. This ts the reason that blanks are 


unacceptable in a line number and that the line of text 
1 0.1 THIS !S A DUMMY LINE 
will not be line 100.1 with content 
THIS IS A DUMMY LINE 
but rather will be line 1.000 with content 
0.1 THIS 1S A DUMMY LINE 
RANGE has already been defined as a group of lines 
which all possess some distinguishing characteristic. The 
most common instance of this is the EXPLICIT TYPE OF RANGE 
where the characteristic is that the line number ties 
within some range of numbers (and hence’ the name range). 


This type of range is. denoted [fn WYLBUR by giving two 


_ explicit line numbers separated by the character / 


1/10 
In the example above, the lines of interest are those 


having a line number greater than or equal to 1.000 and 


‘less than or equal to 10.000. A special case is that in 


which there is only one line in the range 
78,098/78.098 
which may be abbreviated to just the single line number 
78,098 | 
In defining this type of range, the user may employ the 
special line numbers FIRST and LAST, which have as values 
the line numbers of the first and last lines in the data 
set on which the user Is working. (F and L are legal 
abbreviations for FIRST and LAST.) This leads to the 


following possible ranges 


FIRST/10 
1,09/LAST 
or FIRST/LAST 
As a further convenience the user may also specify the 
range FIRST/LAST by using the special. explicit range 
specification ALL. [t should be emphasized that these 
special line numbers and the special range ALL are only 
legal within an explicit range specification. 
A second form of an explicit. range Is just a list of 


line numbers. 


F,10.2,75,114.125,126.01 


WYLBUR - requires that there be no more than ten numbers In _ 


such a list. Also, it Is required that the. Jftne numbers 


are in ascending sequence. 

The second type of range which may be specified.Is the 
ASSOCIATIVE RANGE In which the distinguishing 
characteristic is an Instance of some <CHARACTER STRING. 
This type of range is specified by enclosing the <CHARACTER 
STRING> within quote marks. A 2741 keyboard has two types 
of quote marks available - a single quote (') and a double 
quote ("), Either of these may be used to enclose the 
<CHARACTER STRING> but consistency mus t be malintalined. 
Thus the following are valid associative ranges 


"VARIABLE" 
or "VARIABLE! 


whereas the following is not 
"VARIABLE! 


Also take note that blanks are significant In can 
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associative range specification, so that 


m BLANKS ARE PART OF THE STRING “ 
and "BLANKS ARE PART OF THE STRING" 


are not equivalent range specifications. 

if ‘a quote mark appears in the <CHARACTER STRING>, then 
the user must follow some additional rules. It Is easiest 
to enclose the <CHARACTER STRING> in quote marks of the 
opposite type from those appearing in the <CHARACTER 
STRING. If the user finds that he must use the same type 
of quote marks to enclose the string, then he should type 
those quote marks which appear in the <CHARACTER STRING> as 
two consecutive instances of the quote mark. For example — 


"DON'T" 
and 'DON''T® 


both designate that range of Jlines which contain the 
character string | 
DON'T | 
As an example of the meaning of various associative 
ranges consider the following text 


1. DON'T WORRY IF YOU HAVEN'T UNDERSTOOD 

“2s EVERYTHING SO FAR. WYLBUR IS VERY UNDERSTANDING 
36 AND WILL HELP YOU WHEN YOU MAKE A MISTAKE 

4, DURING A SESSION BY GIVING YOU SOMEWHAT 

5 6 INFORMATIVE ERROR MESSAGES INDICATING 
6. WHAT WAS WRONG AND SUGGESTING A POSSIBLE METHOD 
7. OF CORRECTING THE ERROR. TRYING TO 

8. OPERATE WYLBUR WILL BE THE BEST WAY 

9. YOU HAVE OF LEARNING HOW. TO USE !T. BUT 

10. DON'T THINK FROM THIS THAT YOU SHOULD 
11. NOT READ THE REST OF THIS MANUAL BEFORE 

12. ATTEMPTING TO USE WYLBUR. 


The following associative range specifications give the 


following sets of lines 


"DON'T". <1,10> 
"TH! ¢2,6,7,8,10,11> 
' TH' <7,8,10,11> 


"DON'T WORRY IF YOU HAVEN'T" <1> 

The user may wish to restrict the lines Included in an 
associative range to a certain subset of all lines which 
contain the <CHARACTER STRING>,° He may do this hy 
appending a series of digits which. specify the ordinal 
number of each line which is to be In the subset. Thus, 


using the above example 


"TH! : <2,6,7,8,10,11> 
'TH' (1,3/5) <2,7,8,10> 
‘THY (1,3/6)  €2,7,8,10,11> 


The user may further restrict the chosen. lines” by 


specifying an explicit range In which the search should be 


made 
'TH' IN 7/10 | <7,8,10> 
"TH! (1,3) IN 7/10 <7,10> 
'TH' EN ALL <2,6,7,8,10,11> 


It should be noted that If the user knows that the string 
of tInterest occurs In only a restricted section of his data 
set, he ts doing WYLBUR a _ service to tell him this 


additional information. With this extra Information, 


WYLBUR won't need the perhaps lengthy time required to- 


search the full data set. 


The user may further restrict an associative range by 


suffixing the string with column positions within which the 
string must be contalned In any given line. 
'TH' 6/8 <2,10> 


"TH! 6/8 (1) <2> 
‘TH' 6/8 (1) IN 7/10 — <10> 


Note that the string must begin and end within the 
specified column positions. If only one column position is 
specified, the string is required to start [In that column 
position. 

'TH' 6 <2> 

Blank lines are considered by WYLBUR to be lines with 
null content. Thus the sesoctatt ve range '' or "" would 


retrieve all blank lines in the working data set. But the 


range ' ' or " " would retrieve all lines having one blank 
and at least one non-blank character, i.@. not blank 
lines. 


The fina’ hierarchical form which may be constructed Is 
the DATA SET - the ultimate logical unit which WYLBUR can 
be used to construct, A data set is a group of lines, 


ordered in increasing sequence according to. their line 


number attributes, and corresponds to some logical unit 


such as a Fortran or PL/! program or merely some data set 
of text. A data set has many attributes, the first of 
which is the name of the data set - the data set's DSNAME. 
The DSNAME can be up to 39 characters long and ts of the 
form 
A.B. coo of 

where A through Z must be character strings of less than 
el ght characters and must begin with an alphabetic 
character. 

The next attribute is the place of residence of the 


data set. This Is called the VOLUME attribute of the data 


set and denotes the alphameric name of some data set 
Storage device such asa disk. Current issues of the 
Users' Bulletin give ‘the VOLUME names which are available 
for use in storing private data sets. 


The final attribute of a data set is the EQRMAT in 


which it is written. This may be one of the following 


forms - EDIT, CARD, or PRINT. It should be emphasized that 
these formats only apply to the manner in which data sets 
are stored on external storage devices. When a user is 
' working on one of his data sets with WYLBUR, he is actually 
working on a copy of the data set and this copy is held by 
WYLBUR in EDIT format. 

For a data set to be in EDIT FORMAT means that the line 
number attributes are attached to the lines of text and 
that the content is stored In a special form. 

CARD FEQRMAT consists (as the name implies) of card 
figs - 80 character contents for the lines of text. If 
any line originally had a length greater than 80 
characters, the 8lst and greater characters will be lost. 
Line numbers are not stored with the line contents. 

PRINT EORMAT is the same as CARD format, with the 
single SReaseion that the length of the lines of text is 
133 characters. | 

EDIT, CARD, and PRINT are the standard formats 
available in WYLBUR. In addition, the user may specify the 
exact number of characters in each record by using the 


LRECL type of format 
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LRECL=80 is equivalent to CARD format 
LRECL=133 is equivalent to PRINT format 
LRECL#=122 would access records each having 
122 characters 
The normal WYLBUR user will ordinarily not have to concern 


himself with the use of LRECL format. 


W MMAND 

There are three modes in which WYLBUR can be employed. 
The first is called COLLECT MODE and is that mode in which 
the user Is having WYLBUR construct a new data set or add 
lines of text to an existing data set. The second is EDIT 
MODE in which the user is having WYLBUR make corrections to 
lines in an existing data set. This mode is the most 
important one of the three since it is that for which 
WYLBUR is primarily designed and intended. The third mode 
is APPLY MODE and is that in which the user asks, through 
WYLBUR, that some processing be done on the data set which 
the user has created. The following discussion of the 
WYLBUR commands is split into three sections corresponding 
to these three modes of WYLBUR operation. 

In the following discussion, the data set upon which 
the user iS making modifications is called the WORKING DATA 
SET. This is in contrast to EXTERNAL DATA SETS - all other 
data sets which exist in the system. External data sets 
are therefore those data sets external to the scope of 


attention of the user and his terminal. 


SIGN ON PROCEDUR 

When the user sits down at a terminal, he should first 
check that the COM-LOC switch on the side of the unit Is in 
the COM position (switch up), enabling the terminal to 
communicate to the central processor. The other position 
of this switch, LOC (switch down), puts the terminal into 
local mode of operation in which it acts as a conventional 
electric typewriter. Next the user should check to see 
that the terminal is on by depressing the RETURN key or 
ATTN key. If nothing happens, this means that the ON-OFF 
toggle switch is in the OFF position and should be 
depressed to the ON position. When the terminal is on, 
depressing the RETURN key or ATTN key causes STP (the 
Stanford Terminal Processor - a systems program which acts 


as the interface between the user and the WYLBUR program) 


to start up the sign-on procedure, during which it asks the 


user a series of initial questions so that the validity of 
the user and his account number may be checked. 
STP first types 
p MM/DD/YY HH:MM:S 
STP signifies that the Stanford Terminal Processor is 
Processing the information as an interface between the 
user and WYLBUR. NN shows’ that the user is at a terminal 
which is attached to the central processor through a port 
having number NN, The date is given as month, day, and 


year - MM/DD/YY - and the current time is given as hour (24 
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hour clock), minute, and ‘second - HH:MM:SS. STP follows 


this line with another giving the message of the day - 


“special directions of which the user should be aware. Then 


STP requests that the user supply his name and the user 


should answer by typing his last name and a carriage return 


NAME 2? RIDDLE CR 
STP asks the user to identify himself further by giving his 
account number 

ACCOUNT ?._T000 CR 
The user is then. asked to supply a keyword in order to 
determine that he has a right to use the account number 
which he just gave 

KEYWORD ? FOO CR 
(If the user has not set a keyword, then CR- a b lank 
keyword - is the correct response.) As a_ protection 
feature, STP overprints both the account number and keyword 
with a series of miscellaneous characters. Unauthorized 
use of an account can therefore not be made by a person 
finding output which has been left in a public area. 
Provided that the correct response is made the user is 
asked to supply the number of the terminal which he is 
using 

TERMINAL 2? H15 CR 
The response to this prompt Is found on a label attached to 
the terminal at the right of the keyboard. The user's 


response to this prompt is used by STP. to collect 


statistics on the usage of various terminal units. 
Associated with each valid account number is a list of 
ASSOCIATED TERMINAL NUMBERS. These are used for the 
purpose of insuring that each user can get his falr share 
of the computer's services. Looking at these lists in the 
reverse direction, there is a list of valid account numbers 
associated with each associated terminal number. These 
lists insure a uniformity of service since STP will allow 
only one user from each group assigned to an associated 
terminal number to be signed on at any one time. lf a 


second user attempts to sign on he will receive the message 


ASso RM NUMBER D 
In this manner, one terminal which is rented for the use of 
many people, can not block the use of the system by other 
users who are renting other terminals. 

If auser's account number has more than one associated 
terminal number, then, when he’ signs on, STP will consider 
him as using the first (the associated terminal numbers are 
stored in collating sequence) associated terminal number 
for his account number which is not already being used. If 


the user wishes to override this default decision he may 


explicitly specify an associated terminal number after his 


account number 


ACCOUNT ?. T0000 H26 


It should be reiterated that the user's response to the 


TERMINAL? prompt is used by STP to direct the collecting of 
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statistics on terminal usage and is not used to determine 
the associated terminal number which the user is considered 
to be using. 

During the sign-on procedure, the user {fs conversing 
with STP, As a final step, STP asks the user which 
facility is to be used 

SYSTEM? WYLBUR . 
Note that if only one system is available for use, STP does 
not ask the user this question. 

This completes the sign-on procedure and STP now calls 
in WYLBUR as is indicated by the next prompt 

COMMAND _? 
by which WYLBUR signals that it Is ready to accept 


directives from the user. 


co ODE OF O 

Now that the user has signed onto’ the WYLBUR system, 
let us suppose that he wishes to construct a new data set 
using WYLBUR, Since every session starts with a blank 
working data set, what the user wants to do ts to Input 
consecutive lines of text into this Initially blank working 
data set. This mode of operation is what Is called 
COLLECTing lines of text. The only thing which a user need 
do to enter COLLECT mode is give the COLLECT command 

COMMAND 2? COLLECT 
WYLBUR will now prompt the <LINE NUMBER> and <SINGLE SPACE> 


parts of consecutive lines of text and expect that the user 


will fill in the <CONTENT STRING> part for each line 
Ly 2 THIS 1S AN EXAMPLE 
Zs 2 OF THE PROMPTS AND 
34 2 ANSWERS WHICH TAKE PLACE 
ue 2 DURING THE COLLECT MODE 
Ds 2.0F OPERATION. 
As a convenience, the COLLECT command may be given in one 
of two shortened forms. The first (as with most of the 
WYLBUR commands -- watch for further examples below) is 
just the first three characters of the command word 
COMMAND 2? COL 
The second is a command which is just an ATTN character 
COMMAND ? ATTN*x* 

Before considering other features of the collect mode 
of operation, it is appropriate to explain the function of 
the non-typing keys when they are used during the typing of 
lines of text. 

Carriage return signals that the user has finished 


typing the contents into the line of text and wishes WYLBUR 


to prompt with the <LINE NUMBER> of the next line of text, 


Back-spacing over a character erases it from the line 


of text which is being typed. 


iv ?_AN EXMPLE OF USE 
AMPLE OF THE USE OF THE BACK-SPACE KEY 


results in a line numbered 1.000 and having content 

AN EXAMPLE OF THE USE OF THE BACK-SPACE KEY 
since the user first typed out to the USE, then back-spaced 
to the beginning of MPLE and then typed the rest of the 


line. If the user back-spaces into the <LINE NUMBER> or 
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<SINGLE BLANK> part of the line of text (both of which were 
prompted by WYLBUR), he will lose all characters which he 


may subsequently type into these areas. The example 


9 
$8 ATTEMPT TO CHANGE THE LINE NUMBER 


where the user has attempted to change the line number 
which WYLBUR prompted, will result in a line numbered 1.068. 
with content 

ATTEMPT TO CHANGE THE LINE NUMBER 


Likewise 


ATTEMPT TO OVERWRITE THE LINE NUMBER 
results in a lfne numbered 1.068 with content 
EMPT TO OVERWRITE THE LINE NUMBER 
The attention key has two functions during COLLECT 
mode. If any characters are typed before hitting the ATTN, 
then the ATTN key signals to WYLBUR that the user wishes to 
erase the line which has just been partially typed 
1. 2_THIS SHOWS WHAT HAPPENS WHEN 
THE ATTENTION KEY 1S HIT BEFORE 


3. ? COMPLETING A LINE WITH A 
——ta 2? CARRIAGE RETURN ATTN#** 


mn ? 

The ATTN at the end of line 4.000 causes WYLBUR to 
disregard what was typed into the line, and WYLBUR prompts 
again with the same line number. (lt should be noted here 
that whenever characters are typed into a line -- command 
type as well as a line of text -= and the line Is 
terminated with an ATTN, WYLBUR pays no attention to that 


line and returns the prompt that was just previously made.) - 


The second function of the ATTN key during COLLECT mode is 
to signal to WYLBUR that the user wishes to leave COLLECT 
mode. To give this signal, the user must type the ATTN key 
as the only character in the line. WYLBUR will then forget 
about the line numbered with the last prompt and ask the 
user for a new command 

1s ?_THIS SHOWS WHAT HAPPENS WHEN WYLBUR 

23 2?_1S SIGNALED THAT THE USER WISHES 

3 ?_TO LEAVE THE COLLECT MODE. 

4 ? ATIN«e** 

COMMAND ? 

At line. 4,000 the user typed ATTN, WYLBUR then responded 


with the three asterisks, returned to a new line, and asked 


the user for his next directive. The data set will consist. 


of three lines numbered 1.000, 2.000, and 3.000. A duality 


should be apparent -- an ATTN command is sufficient to get 


the user into COLLECT mode and an ATTN answer’ to a line 


number prompt while in COLLECT mode is sufficient to remove 


the user from COLLECT mode, 

The above examples show that WYLBUR COLLECTs new lines 
of text into a blank working data set by beginning with a 
line numbered 1.000 and obtains line numbers for subsequent 
lines by adding 1.000. These values are under the control 
of the user and he may append modifying phrases to the 
COLLECT command in order to cause WYLBUR- to use different 
values. Directing WYLBUR as follows 

COMMAND ?_ COLLECT 2.098 
will cause WYLBUR to collect lines of text with numbers 


2.098, 3.098, 4.098, 5.098, etc. -- start at 2.098 and add 
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1,000 to get subsequent line numbers. Further modifying 
the command 
COMMAND ? COLLECT 2.098 BY .001 

causes the COLLECTing of lines of text numbered 2.098, 
2.099, 3.000, 3.001, etc. -- start at 2.098 and add 001 
to get subsequent’ line numbers. It should be noted that 
these modifying phrases may not be appended to the COLLECT 
command when the ATTN short form is used. 

| Suppose now that the user has constructed a data set 
(i.e. that his working data set is not empty), and that he 
wishes to add more lines of text. Suppose further that the 
working data set consists of seven lines of text numbered 
1.1, 2.1, 3.1, 4.1, 5.1, 6.1, and 7.1. If the user Issues 
a COLLECT directive, WYLBUR will prompt for lines to be 


added to the end of the working data set 


COMMAND? COLLECT 
8,1]. 2? COLLECTING MORE LINES INTO THE DATA SET, 


9.1. 2 STARTING AT THE END OF THE CURRENT LINES. 


10,1 7? ATTN«x* 
COMMAND _ ? 


The question arises of how WYLBUR derives. the starting 
number of 8.1? The working data set has an attribute, LAST, 
which is defined to be the line number of the last line of 
text. 8.1 is therefore derived by taking this LAST 
attribute and adding the increment which Is currently in 
effect (namely 1.000 unless the user specifies otherwise in 
the COLLECT command). As before, the user may change the 


increment 


COMMAND ? COLLECT BY .1 
7,2. 2? COLLECTING MORE LINES, STILL INTO THE END 


7,3. 2? OF THE DATA SET, BUT NOW WITH A TEMPORARY 
— ot 2? INCREMENT OF .1 

Zp 2? ATTN*** 
COMMAND _? 


The user may also collect lines Into’ the fnterior of 
his working data set, but WYLBUR will not allow any 
existing lines to be overwritten or passed in the process. 
Consider the working data set as above and the command 

COMMAND ? COLLECT 2.1 BY .1 
Since collection of a line numbered 2.1 would cause an 
existing line to be overwritten, WYLBUR will return an 
error message and ask for a mew command. If, on the 
otherhand, the command is 


COMMAND ? COLLECT 2.2 BY .1 
WYLBUR is quite happy to let the user add lines numbered 


2.2, 2.35, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9, and 3.0; but will 


not collect a line numbered 3.1 since it would cause an 
existing line to be overwritten. Finally, tf the command 
were 

COMMAND 2? COLLECT 2.2 BY .4& 
WYLBUR will collect lines numbered 2.2, 2.6, and 3.0, but 
will not pass the existing line 3.1 in order to collect a 
line numbered 3.4. 

While COLLECTing lines the user may perhaps enter a 
line which contains more than LENGTH characters. Normally, 
WYLBUR will only issue a warning message, informing the 


user that this has occurred. However, the user may turn on 


E-25 


E-26 


an OVERFLOW option (see the SET OVERFLOW command below) 
which will cause WYLBUR to place all the extra characters 
into the next line. Suppose that LENGTH is set at 40 and 


that OVERFLOW is set on. 


COMMAND 2? COLLECT 90 BY 10 
90. ?2_THIS 1S A LINE WHICH HAS 4&4& CHARACTERS IN IT 


100. 2_I1N LT AND ADD MORE 


110, 2? ATTN&** 

COMMAND ? LIST 90/110 

—20. THIS 1S A LINE WHICH HAS bu CHARACTERS 
100, LN IT AND ADD MORE 

OMMAND. ? 


Note first that breaks in the line containing excess 
characters aie made only at blanks and never in the middle 
of a word, Also note that the overflowed characters are 
prompted by WYLBUR at the beginning of the next line. This 
overflow rectification process will work with any number of 
characters in the line - WYLBUR chooses successive groups 


of (approximately) LENGTH characters and makes’ them into 


new lines and then prompts for the next line, with the 


extra characters left over already present in the next 
line. if astring of more than LENGTH characters occurs 
without any blanks in it, WYLBUR will abort the overflow 
rectification process with an error message. The 
rectification done up to that point will be preserved, but 
the string itself and whatever follows it in the line just 


entered will be lost. 


USING PREVIOUSLY DEFINED DATA SETS 
Using WYLBUR would become rather tiresome if the only 


way iInwhich a user could get a non-blank working data set 


would be to type in the full text while in COLLECT mode. 
| Therefore, it is possible to give a command to WYLBUR to 
have {it call in a copy of an external data set to use as 
the working data set. This could be a data set which the 


user constructed at an earlier session, a data set which 


has been constructed by another user, or a card deck which 


has been read into the system (the procedure’ for 
accomplishing this last example will be given [In an 
Appendix). 

It should first be emphasized that only a copy of the 
external data set is made available to the user. lf the 
user seriously damages the working data set by making 


disastrous changes (or if the system dies during the 


session - thereby destroying all working data sets), a 


version of the unimpaired data set still exists. 

In order to obtain a copy of the external data set, the 
user should issue a USE command 

COMMAND? USE DUMMY 
where DUMMY is the DSNAME of the data set which the user 
desires. The user’s account number is appended to the 
front of the DSNAME to obtain the real name of the data 
set. In the above example, a data set named T000.DUMMY 
would be searched for on the external storage devices. 

The user may help WYLBUR in its search for the data set 
by giving the VOLUME attribute 

COMMAND? USE DUMMY ON SYS07 


WYLBUR will ask the user to supply the format of the data 
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set 


COMMAND 2? USE DUMMY ON SYS07 


FORMAT ?_ EDIT 
COMMAND? 


and after getting this information, WYLBUR will get a copy 


of the data set to use as the working data set for the 
user, The user may preempt WYLBUR's standard request for: 
the data set format by stating it in the USE command. 


COMMAND 2 USE DUMMY EDIT 
COMMAND. ?_ USE DUMMY ON SYSO7 EDIT 


When WYLBUR obtains the copy, it Is automatically put. 
into EDIT format if it is not already in that format. This” 
means that for CARD and PRINT format data sets, WYLBUR will 
attach line number attributes to every line of text. The 
line numbers supplied will begin with 1.000 and have an 
increment of 1.000 (the increment may be changed - see 
section below on the DELTA global parameter). | 

A user may obtain a copy of a public data set belonging 
to some other user by giving that data set's full DSNAME 
preceded by the & character 

COMMAND 2 USE &****, DUMMY 
where **** must be replaced with the account number of the 
user who constructed the data set named DUMMY. In no cases 
will the original copy of the data set be scratched or 
overwritten by anyone but the user who constructed it. 

The user may specify the LRECL type of format 

COMMAND 2? USE DUMMY LRECL=121 ON SYSO5 


But note that LRECL may not be greater than the number of 


characters in the physical record or the record will be 
ignored. If the number of characters In the physical 
record is not an integral multiple of LRECL, those 
characters remaining after all possible lines of LRECL 
characters have been inserted into the working data set 
will be ignored. 

When using data sets which are in PRINT, CARD, or LRECL 
format, the user may specify that a given number of records 
should be skipped when reading in the data set. 

COMMAND ? USE DUMMY LRECL=80 SKI P=1000 ON SYS06 
This will cause the first 1000 card images’ to be ignored 
and the card image, that without the SKIP phrase would have 


been line number 1001, will be line number 1. 


GLOBAL PARAMETERS 

Global parameters are adjustable features in WYLBUR 
which may be set to an appropriate value, and will remain 
set at that value for the duration of the session or until 
the user resets their value. 

The first global parameter {s the already explained 
LENGTH attribute of lines of text. The user may set this 
to any value between 1 and 133 (inclusive) by use of the 
SET command 

“COMMAND ? SET LENGTH = 80 
If the user does not set the LENGTH attribute, it 
automatically has the value 72. 


The second global parameter is the setting of the JABS 
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at the terminal. These are used aS on a_e standard 
typewriter, but the user must follow a rather rigid 
procedure for telling WYLBUR what the settings are. This 
rigid procedure is necessitated by the way in which a 2741 
works. When the TAB key is pressed at the terminal, the 
typing head is released and travels to the right. A 
protruding bar stops the movement of the typing head at the 
next tab setting. However, the only signal that is sent to 
the computer is one which indicates that the TAB key was 
pressed - no signal is sent to tell the computer where the 
typing head stopped. Thus the tabs may be physically set 
at the terminal, but WYLBUR will not know what the settings 
are until the user completes the following sequence. The 
use initiates this sequence by asking WYLBUR to set the 
tabs | 


COMMAND? SET TABS 


WYLBUR then gives the user directions and a line of column 


numbers 
COMMAND ? SET TABS 
TYPE A "1" BENEATH EACH POSITION AT WHICH YOU SET A TAB, 
23456 Al 45678 D 
START? 


The first thing the user must do is to clear the physical 
tab settings which already exist at the terminal. This is 
done by successively tabbing across the line and depressing 
the CLR toggle switch at each tab until the right-hand 
margin is reached. Then the user should hit ATTN, which, 


will cause WYLBUR to return to the beginning of the next 


line and re-prompt START?. The user then spaces over to 
each successive column in which he wants a tab set, first 
presses the SET toggle switch, and then types a "1" 


COMMAND 2? SET TABS | oe 
TYPE "1" BENEATH EACH POSITIO WH 1 Y I 


12 6789AI12 789B1 56789C12 89 
START? 
START? 1 1 1 1 


The above example shows the successful setting of the tabs 
in columns 10, 20, 30, and 39. 

Alternatively, the user may append to the SET TABS 
command a list of numbers representing the column numbers 
for the tab settings 


COMMAND ? SET TABS = 10,20,30,39 
COMMAND? 


But note that the physical tab settings at the terminal 
should correspond to the information given when using this 
form of the SET TABS command. 

If the tabs have not been set and the tab key is used, 
WYLBUR will pay no attention to the line and wi saws an 
error message, This occurs also if not enough tab stops 
have been set - for example, if only three tab stops have 
been set and the tab key is pressed four or more times. 

The third global parameter is the increment which 
WYLBUR uses to derive one’ line number from its predecessor 
-- DELTA. The user may set DELTA 

COMMAND 2? SET DELTA = XXXX. XXX 
where XXXX.XXX is any decimal number between’ .001 and 


9999.999 (inclusive). If the user doesn't set. DELTA, a 
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default vaiue of 1.000 is used. “So far, the only use of 
DELTA which has been encountered is in the COLLECT mode 
where it was noted that a DELTA of 1.000 was used unless 
the user overrode this value by specifying a different 
value in the COLLECT command (the BY phrase). In 
actuality, the DELTA used is the current value of the 
global parameter -- it was said to be 1.000 because that is 
the default value. 

The QVERFLOW global parameter, used only in COLLECT 


mode, is turned on and off by means of a SET command 


COMMAND ? SET OVERFLOW = ON 
COMMAND ?SET OVERFLOW = OFF 


OVER is a valid abbreviation for the word OVERFLOW. 

The final global parameter is the LAST attribute of a 
working data set, which the reader should remember is the 
line number of the last line of text in the data set. The 
user may not set the value of this parameter explicitly -- 
whenever new lines are added to the end of a data set, the 
value of LAST is implicitly and automatically reset. 

All examples of the use of WYLBUR are typed in upper 
case letters in this manual. This is the normal mode in 
which WYLBUR operates - all alphabetic characters, whether 
typed in upper or lower case are recognized by WYLBUR as 
being in upper case. if the user wishes to use both upper 
and lower case, he must tell WYLBUR | 


COMMAND? SET UPLOW 


Then when the user wishes to revert to normal mode, he 


directs WYLBUR 


COMMAND _? SET UPPER 


Note that regardless of the case mode which is in effect, 


all typing in a command line is recognized by WYLBUR as 


upper case except those characters delimited by quote marks 
(as in associative ranges). Also note that, at present, 
the 1403 high-speed printers are only capable of printing 
upper case. Thus any text listed on the 1403 will be 


printed in upper case regardless of its actual case. 


The discussion above indicates the manner In which the 


global parameters may be set by the user. How can the user 
find out the values of the parameters If he has forgotten 
them? This is done by asking WYLBUR to SHOW their values. 


COMMAND? COLLECT 
Le 2.THIS 1S AN EXEMPLARY DATA SET USED 
2 2_TO REVIEW THE SETTING AND SHOWING 


wreremerene 


39 ..2_0F GLOBAL PARAMETERS. 
b._?_ATTN&x% 
COMMAND ? SHOW TABS 
CURRENT TAB _ SETTINGS ARE NONE. 
COMMAND? SHOW LAST 
CURRENT LAST LINE NO, TS 3. 
COMMAND.?_SHOW LENGTH 
CURRENT LENGTH IS 72, 
COMMAND 2. SHOW DELTA 
CURRENT GLOBAL DELTA IS 1. 
COMMAND 2?.SET DELTA = .01 
COMMAND ? SHOW DELTA 
CURRENT GLOBAL DELTA IS 0,01 
COMMAND 2? SET LENGTH = 80 
COMMAND ? SHOW LENGTH 
CURRENT LENGTH IS 80, 
COMMAND 2? COLLECT 
3,01 2? EXTRA LINE ADDED 
3,02 2? ATTN*#* 
COMMAND? SHOW LAST 
CURRENT LAST LINE NO, IS 3,01 
COMMAND ? SET TABS 
TYPE A "1" BENEATH EACH POSITION AT WHICH YOU SET A TAB. 
123456 789A123456789B123456789C123456789D 12.0. 
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START 2 

START? 1 od 1. 1 
COMMAND ? SHOW TABS 
. CURRENT TAB SETTINGS ARE - 10 - 20 = ~_ 39 - 


COMMAND 2? SHOW CASE 
UPPER CASE ONLY 


COMMAND 2? SET UPLOW 
COMMAND 2? ATTN&** 
3,02 ? AB 
ab 
3,04 2? ATIN*e** 


COMMAND ? LIST ‘ab’ 
———203__ab | 
COMMAND ? SHOW CASE 
UPPER-LOWER CASE 


UPPER= 
COMMAND 2 


This is the heart of WYLBUR --- the primary reason that. 
it was designed and implemented. It is by using these 
commands that the user may have the computer help him in 
changing invalid character strings and lines which his data 
set may contain. Since data sets will most likely be 
programs, WYLBUR is, In a sense, a glorified keypunch. But 
as the user reads the rest of this manual, it is hoped that 
he will see that using this appellation ts a’ gross 
underestimation, ‘since, when used to its full capabilities, 
WYLBUR ts capable of much more than -mere string 
replacement. 

WYLBUR's editing: commands are of two distinct types, 
differentiated by whether the operation called for Is 
effected upon full lines of text or merely “upon strings 
which may appear in the content of a line of text cr 


INTER-LINE and JNTRA-LINE editing. 


to 
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INTER-LINE EDITING 


The most common thing that the user will probably want 


do with his data set is to list It. This he can do by 


commanding WYLBUR to LIST 


COMMAND 2? LIST 

Li THIS JS A DUMMY DATA SET WHICH SHOWS 

2 W S ONS S 

OMM NE_OF 
Pian 2 CRE 
——Ho——___WITH ITSASSOCIATED LINE NUMBER UNTIL 
2A L THE LINES INTHE DATA SET ARE 
D, AT WHICH PO W R 
F OTH 
MAND? 


The user may desire that only an explicit range within the 


data set be listed 


COMMAND ? LIST 3/5 


The user may further wish that his listing not contain the 


line numbers of the lines of text 


COMMAND? LIST UNNUMBERED 

THIS 1S A DUMMY DATA SET WHICH SHOWS 
WHAT HAPPENS IN RESPONSE TO A LIST 
COMMAND. EACH LINE OF TEXT IS PRINTED 
P 

W I MB 


ALL THE LINES IN THE DATA SET ARE 


W R M 


THE USER FOR ANOTHER DIRECTIVE, 
COMMAND ? LIST 3/5 UNNUMBERED 
QMM 0 IS_P 


as an alternative (albeit rather useless in this 
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context) the user may wish to have just the line numbers 
listed 


COMMAND 2 LIST NOTEXT 
—-1La___. 


COMMAND _? 
This NOTEXT option is more useful when the user wants to 
find the line numbers of all lines which contain a certain 
character string - 1t.e. those lines in an associative 
range ~ a case which is discussed next. 
Interesting uses of WYLBUR's listing capabilities arise 
when associative ranges are used 


COMMAND? LIST "DATA SET" IN ALL 


1. THIS 1S A DUMMY DATA SET WHICH SHOWS 
oy ALL THE LINES IN THE DATA SET ARE 


COMMAND _? 
The above example shows that WYLBUR can be used to find 
instances of some character string which Is of interest to 
the use: . WYLBUR has found all occurrences [n_ the 
specified range (in this case all) and printed their Image 
for inspection. The user may also restrict the range in 
which WYLBUR is to search | 


COMMAND ? LIST "DATA SET' IN 4/7 
COMMAND _? 


The user could atso ask for only the line numbers of the 
lines containing the string 


COMMAND ? LIST "DATA SET' IN ALL NOTEXT 
ey eee 


gee ee 


COMMAND 2 
Likewise, the user could append the phase UNNUMBERED 


instead of NOTEXT and receive the line contents only. 


When listing with an UNNUMBERED option, the user may 


specify a MARKER, an instance of which in the first column 
of any line in the range will cause the listing tbe 
temporarily suspended. After suspension, the listing may 
be resumed with a CR command. | 


COMMAND ? LIST ALL MARKER = P UNNUMBERED 


S) DUMMY W H 
WHAT HAPPENS JIN RESPONSE TO A LIST 
C ND N 
CR ra 
W 0 B 
| 
D OLNT WYLB P 


Note that the line containing the MARKER in column one is 
not printed and that the MARKER character is only 
recognized when it occurs fin column one. 

After a little use of WYLBUR, it should be apparent to 
the user that having it list all of a very large data set 
is not very convenient due to the 15 character per second 


speed of the 2741. Therefore the user may command 


COMMAND 2? LIST OFFLINE 
0 U 
—BLN NO, 2 353 oe | 
XXX 1S THE JOB NUMBER FOR YOUR LIST OFFLINE. 
COMMAND ? 


a, 
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This causes WYLBUR to append the necessary JCL cards to the 
data set and put the job into the job queue for HASP. The 
output will be marked as belonging in the bin which the 
user has specified, and the user may monitor the progress 
of his job by using the LOCATE command (see below). The 
user may preempt WYLBUR's standard request for a bin number 
by supplying it in the command prefaced by BIN or B 

COMMAND 2 LIST OFFLINE BIN 353 

Normally the user will want the computer time required 
for the offline list to be charged to the same account 
number that was used in the sign on procedure. He may 
specify otherwise by giving an account number in the 
command prefaced by ACCOUNT, ACCT, or A 

COMMAND _?_ LIST OFFLINE BIN 333 ACCT TOO0O0 
If the user doesn't supply this ACCOUNT phrase, WYLBUR 
assumes that the account number given in the sign on 
procedure is the correct one to use, 

When listing offline, the user may position his output 
on the printer paper by specifying a count of the number of 
blanks to be inserted at the left. | 

COMMAND? LIST OFFLINE (5) B 333 
will produce output which is shifted 5 positions to the 
right. The number of blanks specified must lie in the 
range 1 to 70. In addition, if an unnumbered offline list 
is done, a zero blank count may be specified thus allowing 


the user to list aflile which contains its own printer 


control characters. (When a LIST OFFLINE UNNUMBERED (0) is 


done with a data set that has been created by any of the 

IBM assemblers, WYLBUR needs to be told with an MC phrase 
COMMAND ? LIST OFFLINE UNN (0) MC 

since the carriage control characters output by the 

aseanbiers are not the standard ones used by the 1403 

highspeed printers. WYLBUR passes this phrase on to the 

printers so that they can correctly interpret the carriage 


control characters. ) 


In a LIST OFFLINE command, the user may specify a title 


which will be printed at the top of the first page of the 
output. 

COMMAND 2? LIST OFFLINE B 333 ‘DUMMY ~ AUG 8, 1967' 
Note that the TITLE option is only valid in an OFFLINE 
list, and that there may not be more than 60 characters in 
the TITLE. 

The user may obtain a punched card deck of his working 
data set by giving WYLBUR a PUNCH command 

COMMAND ? PUNCH 2/L UNNUMBERED B 333 ACCT TO00 
lf the UNNUMBERED option is not specified, the line numbers 
will be punched into columns 73 - 80, overwriting whatever 
was in those columns. The BIN and ACCOUNT options work 
exactly as in the LIST OFFLINE command. The PUNCH command 
will automatically produce an offline listing of the cards 
punched. 

The processing called for in both the LIST OFFLINE and 


PUNCH commands is’ twofold. First a short job is run to 
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produce the print and/or punch file. Then the created file 
is printed and/or punched. The user may attach a priority 
+ URGENT, PRIORITY, EXPRESS (only for the execution phase), 
STANDARD, IDLE, or OVERNITE <- to each of these stages. 
STANDARD jis the default priority for jobs entered by the 
card readers, EXPRESS is the default priority for jobs 
entered via WYLBUR, and the others are successively higher 
and lower. Note that EXPRESS is only valid when the 
execution time for the job does not exceed two minutes, 
otherwise the priority will be changed to STANDARD. (A 
fuller explanation of these priority levels and_ their 
concomni tant stares is In the main text of this User's 
Manual.) The user specifies these priorities by attaching 
two phrases to the command, 
COMMAND 2? LIST OFFLINE P B 333 U 

Note first that the initial Jetter of each priority option 
is a legal abbreviation (except for EXPRESS which is 
abbreviated X). The above command calls’ for PRIORITY 
processing and URGENT printing - printing as soon as a 1403 
is aval lable. 

The print stage of the processing may be deleted 
altogether (note that It's senseless to do this in a LIST 
OFFLINE command) by giving a print priority of NOPRINT. 

COMMAND 2? PUNCH B 333 0 N 
This would cause the punch job to be run overnight and the 
offline listing of the cards punched to be deleted. 


If both the run and print priorities are to be the 


same, the user need only specify it once. This single 
priority will be taken to apply to both stages. If the 
NOPRINT priority is given as. the only priority phrase, this 
will cause the run priority to be EXPRESS and the print 
priority to be NOPRINT. 

The user may request WYLBUR to change the line numbers 
of the lines of text in his working data set by giving the 
NUMBER command | 


COMMAND _? NUMBER 


This causes the renumbering of the data set, starting at 


1.000 and using the current value of the DELTA parameter. 
The user may specify another number at which the numbertrz 
is to begin by giving it in the command | 

COMMAND? NUMBER 2.065 . 
which will cause WYLBUR to start at a value of 2.065 for 
the first new line number. -In addition, the user may 
temporarily override the setting of the global parameter 
DELTA and ask WYLBUR to use another value 

COMMAND ? NUMBER 2.065 BY .O1 
lt should be emphasized that this command causes’ the 
renumbering of the total data set and that the user may not 
specify “that only a range (either explicit or associative) 
be renumbered. 

The user may delete lines in his data set by giving the 
DELETE command 

COMMAND ? DELETE 5.03/6.08 


(Associative ranges may also be _ specified in the DELETE 
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command.) This will cause WYLBUR to remove from existence 


all the lines which lie in the specified range. 


Opposite to the DELETE command is the INSERT command 


COMMAND ? INSERT 13,02 
75.02 2 


The user has specified that he wishes to insert a line 
numbered 13.02 and WYLBUR responds with that number and 
expects the user to fill in the contents of the line as 
would be done In COLLECT mode. WYLBUR will not allow the 
user to insert a_ line which has the Same number as an 
existing line In the data set. Note that only a single 
line may be inserted -- the user may not specify that an 
explicit range of lines be inserted. (Remember that this 
can be done by COLLECTing the lines fete the data set.) If 
the user attempts to insert a line with the same number as 
an existing line, WYLBUR prompts with an error message 
telling the user that he should use the REPLACE command (to 
be described next). 

Frequently, the user will want to delete the contents 
of a line and then put another’ line into the data set with 
the same number but with new contents -- i.e. replace the 
contents of some line. This he may do ina single step by 
issuing the REPLACE command 

COMMAND ? REPLACE 13.06 


mods O06 2 
which causes WYLBUR to overwrite the old contents of the 


line specified with the new contents which the user types 


in in response to the line number prompt. The user may 


specify that a range of lines be replaced, in which case 


WYLBUR will prompt successive line numbers from the 
specified range until the range is exhausted. As an 
example, suppose the data set has lines numbered 1.02, 


1.03, 1.031, 1.032, 1.033, 1.04, and 1.05. Then commanding 


COMMAND 2? REPLACE 1.02/1.03 
will result in WYLBUR requesting new contents for lines 
1.02 and 1.03. On the otherhand, requesting 

COMMAND 2? REPLACE 1.03/1.05 
will cause WYLBUR to prompt for new contents of lines 1.03, 
1,031, 1.032, 1.033, 1.04, and 1.05. The user is not 
allowed to replace the contents of a line which does not 
exist in the data set - i.e. use the REPLACE command to 
Insert. Rather, he should use the INSERT command. 

If the user types just ATTN as the new contents of the 
line, the old contents of the IIne are not replaced -- the 
REPLACE command is aborted. 

There are short forms for the DELETE, INSERT and 
REPLACE commands. The first is by giving only the first 
three characters of the command word. The second form Is 
the same for all commands and consists of giving the full 
line of text for the Inserted or replaced line as a 
response to the command prompt from WY LBUR 

COMMAND ?_13.06 PUT IN THIS LINE 
This would cause WYLBUR to put this new line Image Into the 
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data set in its appropriate place which is determined by 
the line number. If 13.06 already exists in the data set, 
then the old dine will be replaced; and if 13.06 doesn't 
already exist, the line will be inserted into the data set... 
The user should be warned of two possible sources of error. 
in using this command. 
1, Be sure to terminate the line number 
with a single. blank. Anything before the 
first blank will be used as’ the line number 
and anything following it will become the 
contents of the new line. 
2, Don't use tabs in typing in the line 
contents, since the typing of the line number 
has displaced the characters in the content 
string by as many spaces as are used for the 
line number. Tabs will still work, but the 
user wiitl find the contents displaced to the 
left of where he desires them. 
if the user foliows the line number with a single blank and 
then a carriage return, the specified line will be deleted. 
(beware !!!) 
The user may find it necessary to copy the contents of 
a range of lines into another section of his working data 
set and may ask WYLBUR to do this for him. Consider. the 
data set as 


1.01 THIS 1S A DUMMY DATA SET WHICH WILL BE USED 
1,02 TO SHOW THE EFFECT OF VARIOUS COPY COMMANDS. 
2.0 = RAND , 

2.01 SAMPLE 

2,02 RUNIN 

3.0 SRFREPP 

6.0 DATA SET 


Listed below are various COPY commands followed by a 
listing of the resultant data set. It is assumed that each 


COPY command is given when the data set is in the form 


EGS 
given above. , 


COMMAND? COPY 2.0/2.02 TO 47 
COMMAND? LIST 


1.0) “THIS 1$_A DUMMY DATA SET WHICH WILL BE USED . 
1,02 10 SHOW THE EFFECT OF VARIOUS COPY COMMANDS. 
20 RAND 
20901 SAMPLE 
2,02 _RUNIN 
20 SREREPP 


6.0 DATA SET 
47.0 RAND 

~— 18.0 SAMPLE 
49,0 RUNIN 


COMMAND ? COPY 3/7 TO 1.03 BY .001 
COMMAND 2 LIST 
1.01. THLS LS A DUMMY DATA SET WHICH WILL BE USED 
oO?) 10. “SHOW THE EFFECT OF VARIOUS COPY COMMANDS. 
1,03. SRFEREPP 
1,03) DATA SET 


200 RAND 
220) SAMPLE 

2,02 __RUNIN 

3,0 SRFEREPP 
6.0 DATA SET 


1201 THIS 1S_A DUMMY DATA SET WHICH WILL BE USED 
~ 1,02 10 SHOW THE EFFECT OF VARIOUS COPY COMMANDS. 
—~—2.00___ RAND. 
—— 2.001 SAMPLE 

2.2.92 RUNEN 

3.0 SREREPP 


4.01 RUNLN 
——0..0. DATA SET 


COMMAND 2? COPY "DATA SET’ IN ALL TO 2.03 BY .001 
COMM iA ND? LIST 
1,0] THIS IS A DUMMY DATA SET WHICH WILL BE USED 
Ser eLT TO_SHOW THE FFFECT OF VARIOUS COPY COMMANDS 
2.00 RAND 
701 SAMPLE 


(This example is actually wrong. The reader 
should try it on WYLBUR and figure out why the 
correct result occurs. If he can't figure out” 
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the reason for the result, he should ask one 
of the SCC consultants.) 


COMMAND? COPY 'DATA SET’ IN 1/5 TO 33 BY .001 

COMMAND? LIST 

___ 1,01. THIS IS A DUMMY DATA SET WHICH WILL BE USED 
__1,02_.. TO SHOW THE EFFECT OF VARIOUS. COPY COMMANDS. 

—~200 RAND. 

— 200) SAMPLE 

—— 2202  RUNTN 

oO SREREPP 

6.0 DATA SET 


33,0 THIS IS A DUMMY DATA SET WHICH WILL BE USED 


The user may copy lines from an external data set by giving 
a FROM phrase which specifies the external data set 
COMMAND? COPY 1/56 TO 35 BY .1 FROM DUMMY 

This would result in all lines which are numbered between 
1.000 and 56.000 in the external data set named DUMMY to be 
copied into the working data set starting at line 35 and 
occupying succeeding lines whose line numbers are 
automatically determined with a DELTA of .1. As with the 
COLLECT mode, the user is prevented from overwriting or 
interleaving existing lines in the working data set. 
Another rule concerning the COPY command is. that = any 
external data set which is specified must be in EDIT 
format. WYLBUR will return an error message if it is not, 
and the user must then get the external data set into EDIT 
format in order to reissue the command. This may be 
accomplished by using the data set (after saving the 
current working data set), which will cause WYLBUR to 
convert the data set to EDIT format, and then saving this 


edited version of the external data set under a new name in 
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EDIT format. | 
If the user wishes to copy a range of lines and then 
delete the old copy of the lines, he may do. this with a 
single command - MOVE, This functions exactly as the COPY 
command with the following exceptions. 
1. The old lines which were. copied are 
deleted, 
2. %It Is not possible to apply the MOVE 
command to an external data set, since a 
basic axiom fs that the user’ may take 
destructive action only upon the current 
working data. set, 
Following are some examples of the MOVE. command as applied 
to the exemplary data set used in the explanation of the 


COPY command 


COMMAND 2? MOVE 3/7 TO 1,03 BY .001 
COMMAND? List | 
M W W 


2,02 RUNIN 
COMMAND ? MOVE 'DATA SET' IN 1/5 TO 33 BY .001 


COMMAND ?_ LIST 
TO 
1 REREPP 


0 MAN 


The TO phrase of both the COPY and MOVE commands may 
specify the special line number’ END. END ts defined as 


DELTA higher than the current LAST of the working data set. 


A-LI 


This completes the discussion of the inter-line editing 
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commands avallable in WYLBUR, This group ifs powerful, by 
itself, as a tool to help the user edit his data sets, but 
requires that the full contents of the corrected line be 
typed when making changes. Helping the user make changes 
such as this in a more convenient manner is the function of 
the intra-line editing commands. | 
The first means of modifying the contents of a line is 
by use of the MODIFY command 
COMMAND 2? MODIFY 23.54 
soe De 000 _B 
ALTERS? 
which causes WYLBUR to print out an image of the line as it 
stands, and then prompt for alterations from the user. The 
first thing that the user wants to do to the shove line is 
to remove the extra 0 characters. This is called deleting 
characters from the content and is accomplished by typing a 


D underneath the characters to be removed 


COMMAND 2? MODIFY 23,54 
23.54 THIS LINE IS roe BE MODIFID 


ALTERS ? 
ATS SE TIHIS LINE 18 TO BE MODIFID 
ALTERS 7? 


Actually the user need type a D only under’ the first and 
last character of the string which is to be deleted -- 
everything between the two D's will also be deleted 


COMMAND 2.1 2 MODIFY 23.54 
oo DU THIS LINE IS Ta08 BE MODIEID 
~ALTERS 2_ 2 
Beas Go re) aera BB "BE 
ALTERS 2? D OD 
22 ot THIS LINE TO BE MOD 
_ALTERS 2 


The user may also insert new characters Into the line by 


first typing an ! underneath the character before which the 
insertion fs to be made and following this with’ the 
character string to be inserted 


COMMAND 2? MODIFY 23.54 
4 M D 


Finally the user may replace a_ string in the line contents | 


by typing an R under the first character to be replaced and 
following this with a string of characters which are the 
replacements. As many characters are replaced, starting 


with the one over the R, as there are characters in the 


string 
COMMAND. ? MODIFY 23.54 
00 MO 
—~ALTERS 2? DD 
4 0 MOD 
ALTERS ? D =O 
MO 
ALTERS ? 1 NOW 
W M 
ALTERS ? ~ RBEING MODIFIED 
Loe o4 THIS LINE IS NOW BEING MODIFIED 
ALTERS 2? 


Using the R indicator restricts the user to replacing a 
number of characters with the same number of characters. 
If the user wants to do a replacement with a different 
number of characters he may use a combination of the D and 
the I indicators 

COMMAND 2? MODIFY 23.54 


S 0 0) 
ALTERS ?_ DD 
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l HIS LIN QO BE MODIF 


23,54 H N NOW TO BE MOD 
ALTERS ? RBEING MODIFIED 
23,54 S_LIN S NOW B MODIFI 
ALTERS ? D DIIN THE PROCESS OF 
2 uy H] | H ROC 0 
The DD caused the word NOW to-be deleted and | under the 
blank following the word NOW caused the string following 
the 1 to be inserted before the blank. The user need not 
type the second D to indicate the range of the deletion 
since the occurrence of the 1! indicator will automatically 
cause the deletion range to be terminated in the character 
position just before the | occurs. The user may also 
follow the D range with a replacement indicator anda 


string of replacement characters 


COMMAND? MODIFY 23.54 
2 ! S 0 MO D 


A S$? DD 
3 HLS tt 210 MODIEI 
ALTERS ? D D 
23.24 I INE 0 MOD 
ALTERS 2 { NOW 
23.24 THIS LINE IS NOW JO BE MOD 
ALTERS? RBEING MODIFIED 
23.54 THIS LINE 1S NOW B MODI 
ARen $2 D DIIN THE PROCESS OF 
23.04 THIS LINE - [IN THE PROCESS OF BEING MODIFIED 
ALTERS 2 RHAS BEEN 
2 | N S MODI D 
WALTERS ? 


The user signals that he has made all alterations to the 
line by not typing anything into the ALTERS line but giving 
only a carriage return 


ALTERS 2? CR 
COMMAND 2 


The above example shows that WYLBUR always’ types out 
the modified image of the line after the user has specified 
the alteration. This may be suspended by typing anN 


before giving any alteration indicators 


COMMAND ? MODIFY 23.54 
000 
ALTERS ? N DD 
ALTERS 2. 


The position of the N is of no concern to WYLBUR as long as 
it appears before any other characters on the alteration 


line. On the other hand, the user may get a copy of the 


modified line, as it stands after correction, by typing a 


few blanks into the alteration line before hitting RETURN 
(remember that just hitting RETURN causes the modification 


process to be terminated) 


COMMAND 2? MODIFY 23.54 


ALTERS 2. CR 


The ATTN key is also used during the modification 
process to signal directions to WYLBUR. First, if it is 
Preceded by any other characters in the alteration line, 
WYLBUR does not pay any attention to that line (remember 
the discussion of the similar use of the ATTN key In 


COLLECT mode) 
COMMAND 2? MODIFY 23.54 
2 


S Q M 
-~ALTERS 2? DDATTN#e** 
ALTERS ? DD 
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lf on the otherhand, no characters are typed into the 
alteration line before the ATTN key is hit, WYLBUR will 
erase all modifications which have been made to the line 
and suspend the modification process 


COMMAND. ? MODIFY 0.09 


0,09 EN ON MODIFI S ALREADY MAD 
~ALTERS 2? D D 


0,09 RENEGE ON MODS ALREADY MADE 
~ALTERS 2? ATTN&*x 
COMMAND 2? LIST 0.09 


0,09 RENEGE ON MODIFICATIONS ALREADY MADE 
COMMAND? 


The user should note that he may make only one 
alteration per ALTERS prompt with the exception of the two 
examples previously given -- a deletion indicator followed 
by either an insertion or replacement indicator. 

The user may also modify a range of lines (elther 
associative or explicit) and WYLBUR will operate in the 
same manner as in the replacement of a range of lines -- it 
will prompt successive lines in the range until the range 
is exhausted, 

Often the user will wish to modify every occurrence of 
some string in some area of his data set or perhaps in his 
entire data set (consider as an example the changing of an 
implicit integer variable name to an implicit floating 
point variable name in a Fortran program). He may use the 
MODIFY command to do this by specifying an associative 
range and then making the appropriate alterations when each 
line is brought out for inspection by WYLBUR. Thus If the 


string to be changed is MAX and it Is to be changed to 


FMAX, the user could direct 

COMMAND _?. MODIFY ‘MAX’ IN ALL 
and make the changes to each line found and prompted by 
WYLBUR. He may do the same function [na _ much easier 
manner by issuing a CHANGE command to WYLBUR 

COMMAND 2? CHANGE 'MAX' TO 'FMAX' IN ALL 
which will cause WYLBUR to search the specified range (in 
this case, the entire data set) and change every occurrence 
of MAX in every line in the range to FMAX, WYLBUR will 
also. print the new image of every line which {it changes 
during the process 


COMMAND ? CHANGE 'MAX' TO 'FMAX' IN ALL 


1,36 FMAX = 0 

10,01 FMAX = FM 1).8B 
9 EM = AM 
COMMAND ? 


if the user does not wish. to have the new Images printed 
out for the changed lines, he may append a NOLIST option to 
the CHANGE command 


COMMAND 2? CHANGE 'MAX' TO 'FMAX' IN ALL NOLIST 
COMMAND 2 


The user may wish to restrict the changing of the 
occurrences to only a section of the data set which he may 


do by giving a range specification rather than the phrase 


ALL 
COMMAND ? CHANGE 'MAX' TO 'FMAX' IN 999/9999 
299, FMAX = FMAX/NSAMP 
COMMAND 2 


The user may further wish to change only a_ specific 


occurrence of the string in each line. This is done by 
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modifying the string to be changed with a number giving the 
ordinal position of the occurrence which is to be changed. 
Consider the result derived in the next to last example and 
the case that the user wishes to change the function name 
back to MAX. 

COMMAND ? CHANGE "EMAX? (2) TO 'MAX' IN 10.01 

FMAX x 1),8 FE MAX 

Cian 2 
The (2) specifies that only the second occurrence of FMAX 
is to be changed. 

The user maybe confused by an ambiguity between 
ordinal positions of character strings to be changed and 
the ordinal position of the subset of lines in an 


associative range. Consider the following possible command 


COMMAND 2? CHANGE 'MAX' (2) TO 'FMAX' IN 'MAX' (2/6) 
What does it mean? First of all WYLBUR is told to direct 
its attention to the second through sixth lines in the data 
set which contain an instance of the string MAX. Within 
this subset of lines, WYLBUR is told to change the second 
occurrence of the string MAX in each line to FMAX. 

Frequently, a user may desire to change the characters 

in a certain group of character positions within a range of 
lines, This may be done by specifying the numbers of the 
first and last character positions in the group. to be 
affected 

COMMAND ?._CH 2/h TO 'MX' IN 10/999 


__ 10,01? EMX FMA 1),8 FEMA 


999, __?_FMX_= FMAX/NSAMP 
COMMAND 2? 


If 2/2 had been specified as the group of character 
positions, only column 2 would have been changed. Further, 
if only 2 had been specified, the string MX would have been 
Inserted before column 2 in the old line 

COMMAND 2. CH 2 TO ‘MX’ IN 10/999 

a RHAX = EMAX/NSAMP 

COMMAND? 

The user may combine the string and column position 
notations to restrict the change to a string which is 
contained in a specified group of columns. Using the 
original example data set given above, consider’ the 
foltowlng exemplary commands 

COMMAND ?.CH 'MAX' 7/10 TO 'FMAX' IN ALL 

——h. 36  _FMAX = _0 

20.01  FMAX = MAX(AC1), BCI) MAX) 

TOD eae aa? C2) TO 'FMAX' IN 10,01 

COMMAND 7? 
In the first change, every occurrence of MAX in columns 7 
through 10 (note that the string must be wholly contained 
within the specified group of character positions) is 
changed. In the second, only the second occurrence of MAX 
which .occurs in columns 11 through 72 Is changed. The 
first change could be effected by commanding 

COMMAND. 2.CH 'MAX' 7 TO "FMAX' IN ALL 
since, If only one column position Is specifled, the string 
'MAX' Is restricted to begin Im that column position. 

APPLY COMMANDS. 


These commands, as the name implies, are used to 
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request extra processing on the user's working data set. 
This is directly analogous to the situation in which the 
user has extra processing done on a card deck by submitting 
it to the computer through dispatch or the card readers. 

The most important such command is’ the RUN command 
which directs WYLBUR to put the user's data set into the 


input stream of the HASP monitor 


COMMAND? RUN 


This is exactly the same as submitting a program through 
dispatch or the card readers. The data set must bea 
logically complete unit containing all of the necessary JCL 
cards just as would be necessary in submitting a run. 
WYLBUR merely puts the data set into the input stream and 
informs the user of the job number which has been 
associated with the data set so that the user may monitor 


the job's progress. 


COMMAND? RUN 
256 IS THE JOB NUMBER FOR YOUR RUN, 
COMMAND? 


When the RUN command Is given, WYLBUR automatically 
makes a copy (in CARD format) of the working data set so 
that the data set is acceptable to HASP. (The user should 
be careful not to run a data set which contains lower case 
characters since they are not converted to upper case.) In 
addition, the line numbers are automatically put Into 
character positions 73 through 80, overwriting whatever was 


in these positions. Thus the output from the run will 


contain the line numbers to facilitate further editing. If 
the user does not wish the line numbers’ to overwrite 
character positions 73 through 80, he must append an 
UNNUMBERED phrase to the command 

COMMAND? RUN UNNUMBERED 

Run and print priorities may be attached to the RUN 
command in the same way that they are attached to the PUNCH 
and LIST OFFLINE commands 

COMMAND ? RUN URGENT NOPRINT 

After the job has been’ submitted through WYLBUR, the 
user may wish to find out what (if any) processing has been 
done on the job. Thus he may ask WYLBUR 

COMMAND 2? LOCATE 256 
and WYLBUR will respond with the current status of the job 
-- it is waiting, [it is finished execution, it is waiting 
for the printer, it is on the printed, etc. If WYLBUR can 
not find the job requested, it will tell the user that the 


job has most likely finished all its associated processing. 


In the LOCATE command, the user may also search for a 
Job by its job name rather than its job number 


COMMAND ? LOCATE RUN1 
YOB_ 118 


—WOB 234 
~MOB 226 1S AWAITING EXEC 


This causes the batch stream to be searched for all jobs 
which have the name specified by the user. The job number 
of each is printed and the status of the last one found is 


determined and printed for the user, 


E-57 


E-58 


parere running a job, the user may wish to. send a 
message to the operators concerning tape mounts, etc. This 
is done with a varient of the SHOW command 

COMMAND ? SHOW OPERATOR 'JOB MANUAL WELL NEED TAPE 231' 
In general, this message sending capability should be “ged 
to communicate the special instructions which the user 
would put on the job request cafd of a batch job. 

The user ney wish to determine what load exists In the 
system. Thts is done by asking WYLBUR to show the status 


of the syster. 


COMMAND 2? SHOW STATUS 
OB 1 , 


JOB 18 XE 
JOB BEIN XE CU 
12_ JO AWA 4 
OB WAIT. R 257 
bO PERCENT SPOOL DISK(S) UTILIZATION 
COMMAND ? 


This command, coupled with the LOCATE command, gives the 
user a means of finding his job and determining a 
reasonable estimate of when it will be executed. 

The user may determine the queues walting for execution 
and printing, broken down Into priority classes, by issuing 


the appropriate SHOW commands 
COMMAND ? SHOW RUN 
U 3 


—~URGENT 3 
PRIORITY & 
EXPRESS 20 
: D_35 
IDLE 20 
OVERNITE 25 
COMMAND 2? SHOW PRINT 
URGENT 3 
PRIORITY 6 
ANDARD 20 


[DLE 35 


OVERNITE 20 
COMMAND? 


This information will help the user in deciding what 
priorities to attach to his program. 

The second apply mode command Is ALIGN, This command 
causes WYLBUR to process an explicit range In the working 


data set so that at most LENGTH characters are on each 


line. Splits in a line are always made at a blank - a word 


is never split between two lines. In addition, any line 
which has a special MARKER character in its first colunn 
(this MARKER character must be specified In the ALIGN 
command if this option is to be used) is not aligned and 
will cause the alignment process to be restarted at that 
Tine. In addition to the special MARKER’ character 
specified by the user, a blank fn column one (as In 
Indented material) causes the alignment process to be 
restarted. 


COMMAND 2? SET LENGTH = 80 
COMMAND ?_ CLEAR 
COMMAND 2? COL 11 
ee ee P THIS 1S A SAMPLE DATA SET USED TO 
12. 2 SHOW THE EFFECTS OF 
Sy 2? POSING THE ALIGN 
14. 2 COMMAND TO WYLBUR. 
tee THE P MARKERS IN 
af. COLUMN ONE CAUSE THE RESTARTING 
17. OF THE 
18, 2 fal, FERMENT CHRO LESS: BUT 
—19,  ? NOTE THAT ONE OF THE LINES BEGINS WITH A WORD 
20. 2? WHICH BEGINS WITH P SO THAT 
21. 2. THE MARKER MUST BE CHANGED. 
oe 2? INDENTED MATERIAL 
2353 2 WON'T BE ALIGNED 
24h. PATINA 
COMMAND ?_CH ' ' 170 '$ ' IN ALL NOLIST 
COMMAND 2? SET LENGTH = 30 
COMMAND ? ALIGN 19/L MARKER = $ 
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COMMAND ? LIST 8/L 
8 ROCES 
NO HAT_ONE O LN 
B W WORD WHIC 
WIT Q 
RK U D 
? N MATER 
—lh, 2? WON'T BE ALIGNED 
COMMAND ? ALIGN ALL MARKER = $ 
COMMAND 2 LIST 
L. $__ THIS IS A SAMPLE DATA SET 
2 SE 0 
OSIN No AND 
be WYLBUR., 
T KER 
Q AUS R RTING O 
7 TH MENT PROCESS, BU 
NOTE T OF _T 
W WOR l 
E P_SO 
RKE S 
12, 2? IND D MATER 
2? WON'T B N 
COMMAND ? 


Note that the align process causes a complete renumbering 
of the entire data set starting at 1.000 and using the 
current DELTA. 

A temporary LENGTH, for use only during an execution of 
the ALIGN command, may be specified in the command 

COMMAND? ALIGN ALL LENGTH = 4&0 MARKER = $ 

If WYLBUR attempts to ALIGN a line which has no blanks 
and is longer than the current LENGTH, an Image of that 
line will be printed with the appended error message TOO 
LONG and execution of the align command will be aborted. 
The Jine that was too long will be lost from the data set 
and no renumbering will be done except for those lines 
which have already been aligned before the error occurred 


(and these numbers will not follow any prescribed method of 


determination). 


S) NEOUS COMMAND 

The user may destroy any of his external data sets by 
commanding WYLBUR to scratch them 

COMMAND 2 SCRATCH DUMMY 
WYLBUR will remove the data set specified from existence. 
WYLBUR will not permit the user to scratch any data set 
except those which belong to him. } 

The user may ask WYLBUR to show the names of all the 


external data sets which belong to the user 


COMMAND 2? SHOW DSNAMES 
USER DATA SET DIRECTORY 
SY$07 . 
DUMMY 11/13/67 
R Q8 


SYSO4 
MANUAL 02/30/68 
COMMAND 2? 
and as indicated, WYLBUR will return the DSNAME and VOLUME 
attributes of all external data sets which belong to the 
user. 
The user may specify that only the DSNAMES of his data 


sets residing on a particular volume are to be found. 


COMMAND 2? SHOW DSNAMES ON SYSO4 


The current time of day, In hours, minutes, and 
seconds, may be obtained by Issuing a SHOW TIME command 


COMMAND 2 SHOW TIME 
19:43:15 


WHEN FINISHED WITH EDITIN 


The user will most likely want to save a copy of the 
data set which he has been using WYLBUR- to construct and 
correct. This is accomplished by directing WYLBUR to save 
the current version of the working data set with some 
specified DSNAME 


COMMAND ? SAVE DUMMY 
FORMAT? 


WYLBUR always requests what format the data set Is to be 
saved in, and the user may preempt this standard request by 
giving the format in the command 

COMMAND 2? SAVE DUMMY CARD 
If the data set already exists on an external data set 
storage device, the user will be told and asked if he 
wishes WYLBUR to scratch the old version of the data set 


and replace it with the new version currently being saved. 


COMMAND? SAVE DUMMY EDIT 


"T000,DUMMY' ALREADY EXISTS. DO YOU WANT TO SCRATCH IT? 
REPLY 2? YES 


A YES answer causes WYLBUR to scratch the old and save the 
new version of the data set, A NO answer causes WYLBUR to 
terminate the processing of the SAVE command and request a 
new command from the’ user. The user may preempt the 
standard request for permission to scratch an existing data 
set by appending the phrase SCRATCH to the end of the SAVE 
command. 


A data set may be saved as a private file by specifying 


PRIVATE. 

COMMAND 2? SAVE DUMMY ON SYSO4& PRIVATE 
Any data set saved in this manner will be available for 
access only by auser signed onwith the correct account 
number - no other user may access the data set, even by 
specifying its full OSNAME, The full DSNAME will be 
XXXX.*.DUMMY, where XXXX is the user's account number. 

The user may designate that the data set be saved on a 
particular storage device by giving Its name in the SAVE 
command 


COMMAND 2? SAVE DUMMY ON SYS07 CARD 


If the user does not ‘specify the desired VOLUME attribute,. 


WYLBUR will put the data set onto any device which has 
room, and tell the user where the data set was stored. 
Normally, line numbers will not be retained when a data 

set is saved in CARD format. Instead, the data set will be 
renumbered (from 1.000 by DELTA) when the data set is used 
again. The user may, however, specify that he wants the 
line numbers retained 

COMMAND 2? SAVE DUMMY ON SYS06 CARD NUMBERED 

COMMAND 2 SAVE DUMMY ON SYS06 LRECL=80 NUMBERED 


Note that this option is anly valid when 80 byte records. 


are being saved. The line numbers will overwrite the 
contents of character positions 73-80, If the user has 
saved a data set with line numbers retained and in 80 byte 
records, he must explicitly tell WYLBUR this fact when he 


next uses the data set 
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COMMAND 2 USE DUMMY ON SYSO6 CARD NUMBERED 
if this isn't done, the old, retained line numbers will 
appear in column positions 73-80 and the data set will be 
renumbered from 1,000 by DELTA. When NUMBERED is 
specified, the line numbers for the data set are taken as 
the contents of column positions 73-80 and these columns 
are replaced with blank characters. If the contents of 
character positions 73-80 are not numeric tine numbers in 
ascending order, WY LBUR will do its own line numbering. 
The numbers must be in ascending order and if two lines 
appear with the same line number, then only the second will 
be retained in the working data set. 
if the data set is being saved in CARD, PRINT, or’ LRECL 
format, a blocking factor may be specified, Indicating how 
many lines of length LRECL should be placed into each 
logical record. The product of LRECL and the blocking 
factor must be less than or equal to 3520. The blocking 
factor is specified as an integer enclosed in parentheses. 
COMMAND 2 SAVE DUMMY ON SYS17 LRECL=80 (44) SCRATCH 
COMMAND 2? SAVE DUMMY1 (10) PRINT ON SYS05 
OMM 2 
In the first case above, each block will contain 4&4 80-byte 
records, In the second, each block will contain = 10 
133-byte records, 
After the user has saved a copy of the working data set 
in the desired format, or if he does not wish to keep a 


copy of the working data set, he may clear the working data 


set (i.e. return the working data set to its initial empty 
state) by commanding WYLBUR to clear 

COMMAND 2? CLEAR 
The user is cautioned against indiscriminate use of this 
command, since its effect is irreversible (unless, of 
course, a copy of the data set has been saved). CLEAR only 
affects the working data set, and the settings of the 


global parameters are unaffected. 


END OF SESSION - LOGOFF PROCEDURE 
All the user need do to end the session Is issue a 
LOGOFF command 
COMMAND _2 LOGOFF 


WYLBUR will reply with various statistics on the session 


COMMAND? LOGOFF 
ELAPSED TIME = 00:04:32 
END OF SESSION 

# 


The elapsed time is the time which the user has been 
sitting at the terminal. In addition, WYLBUR keeps track 
of activity at a terminal and if nothing has been typed [n 
at a logged on terminal for a pertod of five minutes WYLBUR 
will ask the user to take some action to show’ that he is 
still there 
MMAND_ ? Q 1 H 

If the user doesn't type something in reply (carriage 
return is sufficient) then WYLBUR. will give him another 
five minutes and then ask again 


Z QOU_S H 
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OMMAND_? SOM W _B 
If no reply Is made, WYLBUR will logof f the terminal. 

The user is warned that the logoff command Includes an 
implicit clear command -- the current working data set is 
not saved. The user must save’ the working data set, if he 


wishes to, before logging off. 


EROM UR 

Frequently, the user may want some information ora 
review of some command or aspect of WYLBUR, For this 
purpose, the data set TOOO.WYLHELP may be called. This 
data set contains short explanations of the commands plus 
explanations of the use of ATTN, carriage return, line 
numbers, etc.. The following procedure should be used to 
obtain help. 


COMMAND 2 SAVE ..cc0. 
COMMAND 2 CLEAR 
COMMAND 2 USE &TOOO.WYLHELP EDIT 


COMMAND 2? LIST ‘NAMES 
This wlll be a listing of the first line which 


pertains to information on NAME, which is a command or 
some other aspect of WYLBUR, 


COMMAND ? LIST N/LAST 
This listing will be an outline of the information 
which the user desires. N fs the lfne number of the line 
listed In response to the LIST 'NAME' command. The user 
can abort the listing when he has information desired. 


COMMAND 2 
The fille TO00.NEWS contains information on changes and 
additions that have been made to WYLBUR subsequent to the 
printing of this manual. As in the WYLHELP data set, a 
directory to the information is present at the beginning of 


the data set, 
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ND LX 
Index and Outline of Commands 
This appendix gives a succinct review of all WYLBUR 
commands as well as references to Information In the text 
of this manual on the commands and other’ key features of — 
WYLBUR, 
For each command, the format is given in outline Form 
under the following rules | | 
Syntactic types are denoted by enclosure 
in <...> brackets. Each syntactic type’ is 


discussed under its own heading. 


- Optional phrases are denoted by enclosure 
inl...) brackets. 


Alternative choices are separated by a | 
character and are enclosed in (...) brackets. 
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VALID ABBREVIATIONS 
BY none ON none 
SKIP none EDIT none 
CARD none PRINT none 
LRECL none URGENT U 
PRIORITY P STANDARD S 
IDLE | OVERNITE 0 
NOPRINT N EXPRESS Xx 
OVERFLOW OVER COLLECT COL,C 
USE none SAVE ‘none 
SCRATCH none CLEAR none 
RUN none LOCATE none 
LOGOFF none LIST none 
NUMBER none INSERT INS 
REPLACE REP COPY none 
MOVE none SET none 
SHOW none MODIFY MOD 
CHANGE CH PUNCH none 
ALIGN none FIRST F 
LAST L END — none 
LENGTH LEN UNNUMBERED UNN 
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NOLIST none NOTEXT none 
OFFLINE OFF BIN B 
ACCOUNT ACCT,A MARKER none 
TO none FROM none 
DELTA none TABS none 
UPLOW none UPPER none 
OFF none CASE none 
OPERATOR none TIME none 
STATUS none PRINT none- 
{N none DELETE DEL 
DSNAMES none NUMBERED none 
MC none PRIVATE none 
ALLGN COMMAND 


ALIGN <EXPLICIT RANGE> [_LENGTH=XXX_] MARKER=C 

This causes the contents of the lines in the specified 
<EXPLICIT RANGED to be changed so that as many full words 
as possible are in a line but such that no line’ contains 
more than LENGTH characters. Splits in a line are made 
only at blanks. After the lines in the specified <EXPLICIT 
RANGE> are aligned, WYLBUR renumbers the entire data set. 
One blank is inserted after each word unless it ends with a 
- Or ? or !, which force two blanks. (See page E-59 ff.) 

If LENGTH is not specified in the command, the current 
value of the global LENGTH is used. (See page E-60, E-29.) 

The MARKER option must be specified in the command if 
this feature Is desired. When the MARKER character era 
blank occurs In column one of any line in the range being 
aligned, the alignment process is restarted at that line. 


(See page E-59,) 


ASSOCIATIVE: RANGE 


A group of lines designated by giving a _ string, an 


occurrence of which in any line In the data set will 
stenify that that line containing the string is to be 


Included in the range. The form of an associative range is 


'stRING’ [NC/M] Jimal,mp ... MNJ) IN <EXPLICIT RANGED 
(See page E-11 ff.) 

Either single quote (') or double quote ("') marks may 
be used to delimit the string, but consistency must be 
maintained. If the same quote mark appears in the string 
as Is used to delimit the string, the internal occurrence 
must be repeated tice: Blanks are significant in the 
string, including leading and trailing blanks. (See page 
B11, E126) 

The IN phrase’ gives an explicit range in which lines 
containing an Instance of the string are to be searched 
for. (See page £-13.) | 

The first set of suffix modifiers indicates column 
positions within which the string must be contained in any 
given line. If only the first one of the two column 
positions is specified, the string is constrained to start 
in that column. (See page E-13, E-14.) 

The second set of suffix modifiers can be of two forms 

M M/N 
and serve to to limit the range to a specific subset of 
lines, namely those whose ordinal positions in’ the set of 
all lines containing the string are given by the modifiers. 


Thus (3) and (3/7) restrict the subset to the. third and 
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third through seventh lines, respecively, which have an 
occurrence of the string in the specified explicit range. 
In other words, if a line is found in the specified 
explicit range which contains an instance of the string, 
then that line is included in the associative range only if 
it is the Ith line containing the tnstance and the i 
modifier is given. If no modifiers are given, all lines 
containing the string and in the specified explicit range 
are included in the associative range. (See page E-13.) 

The correct associative range to retrieve blank lines 


is the null string - ‘'' or mt, Associative ranges 


: m6 ~2 ") will. 


consisting of only blanks (e.g. 
retrieve lines which have the specified number of blanks 
and also have at least one non-blank character - blank 


lines will not be retrieved, (See page E-14.) 


ATIN KEY 


Typed as other than the first character In a line, this 
signals that WYLBUR should not pay any attention. to the 
line. (See page E-22, E-51.) 

Typed as an answer to any prompt, this signals that 
WYLBUR is to abort execution of the command. (See page 
E-235, E-&3, E-51, £-52.) 

Typed while a listing is being done, this key suspends 
the rest of the listing. 


Typed while WYLBUR is putting out a message at the. 


user's terminal, this suspends the printing of the rest of 


the message. 


Given as an answer to a COMMAND ? prompt, this key puts 


the user into collect mode. (See page E-21.) 


BACK-SPACE_ KEY 
Back-spacing over any character typed by. the user 
erases it from the line. .This applies to command as well 


as text lines. (See page E-21 ff.) 


CARRIAGE RETURN 


This must be the final character of every line. It 
stgnals to WYLBUR that it should ‘Yook at the line and take 
appropriate action. | 

Given as the only alteration to be made toa line (in 
the MODIFY command), it signals that all modifications have 


been made to the lIne. (See page E-50.) 


CHANGE COMMAND 


This. command allows the user to change a specified 


character string tn all lines which are’ in some specified 
<RANGE> in his working data set. 

CHANGE '"STRINGA' Cel/a] J(cn) J To 'STRINGB' IN <RANGE> 
The specified <RANGE> is searched for lines contalning an 
Instance of STRINGA. In each of these lines, the specified 
occurrence of STRINGA is changed to STRINGB. . (See page 
E-52 ff.) a 


The P and Q modiflers. restrict the instance of STRINGA 


to be wholly contained In columns P through Q of the line. - 
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If only P is. specified, STRINGA is restricted to start in 
column P of the line. (See page E-55.) 

if the N modiffer is not given, all occurrences of 
STRINGA in’ the line are changed. N=3 would specify the 
third occurrence in the line. (See page E-53.) | 

CHANGE X[/Y] TO 'STRINGB' IN <RANGE> 

In this alternative form, changes are made to columns X 
through Y of each line in the <RANGE>. If X and Y are both 
specified then the characters in positions X through Y are 
replaced by STRINGB. If only X Is specified, STRINGB Is 


inserted before character position X. (See page E-54 ff.) 


CLEAR COMMAND 
This command scratches the current <WORKING DATA SET>. 
The settings of global parameters are unaffected. 
CLEAR 


(See page E-64.) 


COLLECT MODE 

Mode in which a series of lines are entered into the 
data set with WYLBUR calculating and prompting successive 
line numbers. | 

coLttect [xxxx.xxx_] [By yyyy.yyy] 
(See page E~-20 ff.) 

Lines are collected into the data set beginning with 
line XXXX.XXX, and deriving successive line numbers by 
using a DELTA of YYYY.YYY, If YYYY.YYY isn't specified, 


the current value of the global DELTA [s used. Sf XXXX. XXX 


isn't specified the starting number jis DELTA higher than 
the LAST (number of the last line) of the data set. (See 
page E-24,) 

The COLLECT command will not allow overwriting or 
interleaving existing lines in the data set. (See page 
-E-25.) 

If the OVERFLOW global parameter is set ON, lines 
containing more than LENGTH characters will be truncated at 
the last blank occurring before LENGTH characters and the 
remaining characters will be prompted, with the line 
number, as the start of the contents of the next line to be 


COLLECTed. (See page E-25 ff.) 


COPY COMMAND 
This command allows the user to copy a <RANGED>D to 
another spot in the <WORKING DATA SET>. 
COPY <RANGE> TO (XXXX.XXX|END) LBY YYYY.YYY_| 
[From <pSNAME> LON <votume>] | 


(See page E-44& ff.) 


A copy of the specified <RANGE> is placed in the. 


<WORKING DATA SET>, beginning at a line numbered XXXX. XXX 
and deriving successive line numbers by using YYYY.YYY 

lf YYYY.YYY is not Spent ied: the default value is the 
current working DELTA. If the value of DELTA (specified or 
default) would cause’ the copied lines to interleave 


existing lines in the data set, WYLBUR = automatically 
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calculates a new value of DELTA so that interleaving does 
not take place. (See page E-46.) 

The special line number END is defined as DELTA higher 
than the current LAST. (See page E-47.) 

Existing lines in the data set may not be replaced by 
using the COPY command. 

The <RANGE> Is taken from the <WORKING DATA SET> unless 
the FROM option is present, in which case, the <RANGE> will 
be taken from the named <EXTERNAL DATA SET>, which must be 
in EDIT format. (See page E~-46.) | 

There is an anomaly when a COPY is done from an 
<EXTERNAL DATA SET>. This occurs only when the <RANGE? is 
specified as FIRST, FIRST/FIRST, LAST, or LAST/LAST ~~ the 
first or last line of the <EXTERNAL DATA SET> wlll not be 


retrieved correctly. 


DELETE COMMAND 
This allows the user to delete a <RANGE> in the 
<WORKING DATA SET>. 
DELETE <RANGE> 
(See page E-41.) 
An alternate form may be used. This consists of giving 
an <LINE NUMBER> followed immediately by a carriage return 


as the command. (See page E-43. ) 


DSNAME 
This is the name of a data set. Any tdentifier is 


legal as long as it has no more than’ eight characters and 


begins with an alphabetic character. WYLBUR automatically 
appends the user's account number to the beginning of the 
DSNAME - e@.8. DUMMY becomes T000.DUMMY for a user with 
account number T000. If a user wants to obtain a copy of 
another user's data set, he must give the full name 
preceded by & ~ e.g. &TO00.DUMMY, (See page E-14.) 

EXP R 

A group of lines designated by giving the upper and 

lower limits on the line number. 

XXXX. XXX/VYYY.YYY 
XXXX.XXX must be less than or equal to YYYY.YYY. if 
XXXX.XXX = YYYY.YYY, then the range may be specified by 
ziving only the single number. (See page E-10 ff.) 

The first line of the <WORKING DATA SET> may be 
referred to by the implicit reference FIRST. Similarly, 
LAST will reference the last line. The special explicit 
range ALL Is equivalent to FIRST/LAST. (See page E-10.) 

An alternative form of an explicit range is just a list 
of (ten or fewer) line numbers, e.g. 

10.01,20,12,125,199,015 
The numbers In the list must be In ascending order. (See 


page E-11.) 


EXTERNAL DATA SET 
Any data set external to the current scope of attention 


of a user, (See page E-16.) 


FORMAT 

The storage configuration of a data set. EDIT format 
has line numbers. stored with the text in a special form. 
CARD format has lines stored as 80 byte records (i.e. card. 
images) without line numbers unless the user directly tells 
WYLBUR to store the line numbers also. PRINT format has 
lines stored as 133 byte records without line numbers. 
LRECL=XXX has lines stored as XXX byte records - XXX must 
lie in the range 1 to 133 =- without line numbers unless 
XXX=80 and the user specifies that line numbers are to be 


stored, (See page E-15 ff.) 


INSERT COMMAND 

This command allows the user to insert a line of text 
into the working data set. Only one’ line may be inserted 
-- insertion of more than one’ line must be done by using 
the COLLECT command. 

INSERT <LINE NUMBER> 

This command causes WYLBUR to prompt with’ the specified 
<LINE NUMBER>, after which the user should type in the 
contents of the new line. (See page E-42.) 

The specified <LINE NUMBER> may not already exist in 
the <WORKING DATA SET>. 

Alternatively, insertion may be accomplished by giving 
a command consisting of the <LINE NUMBER>, followed by a 
single blank character, and the contents of the new line of 


text. In this alternative form, if the specified line 


already exists in the <WORKING DATA SET>, then the old 
contents. will be overwritten -- a replacement is done 


rather than an insertion. (See page E-43.) 


LINE NUMBER 

Any number of the form XXXX. XXX between 2001 and 
9999.,999, Leading and terminal blanks may be dropped. The 
decimal point may be dropped in the case that the number is 
an Integer. 

0065.000 = 65.000 = 65, = 65 
(See page E-7 ff.) 
LIST COMMAND 

This command allows the user to obtain a listing of 

part or all of the <WORKING DATA SET>. 
List [crAnce>] CuNNUMBERED] (CNOTEXT] [MARKER=C ] 
LorrLine Bin yyy [(N)_] [account xxxx] ['titLe'] 
[<RUN PRIORITY>] [KPRINT PRIORITY>] [mc] J 
(See page E-35 ff.) 

If no options are specified, the entire data set is 
printed. (See page E-35.) 

The <RANGE> Bpraee limits the listing to that of some 
specified set of lines. (See page E-35.) 

The UNNUMBERED option produces a_ listing containing 
only the text of the lines in the <RANGE>. (See page E-35, 
E-37.) - 

The NOTEXT option Suppresses printing of the text and 


the listing will consist of only the line numbers of the 
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lines in the specified <RANGE>,. (See page £-36.) 

The effect of the MARKER option is to cause the listing 
to be suspended whenever a line is_ reached which contains 
the MARKER character, C, in column one. The suspended 
listing is restarted by giving a CR command, and an ATTN 
command while the listing is suspended will eauee the rest 
of the listing to be aborted. Note that the MARKER option 
has no effect on an OFFLINE listing. or when UNNUMBERED is 
not specified. (See page E-37.) | | 

The OFFLINE modifier signals that the user wishes a 
printing of his data set on the 1403 highspeed printers. 
The user must tell WYLBUR his bin number, = YYY. In 
addition, he may have the charges incurred put ate Account 
XXXX and if this Isn't specified, the charges will be put 
onto the Account with which the user logged on. (See page 
Fes...) 

The (N) phrase causes the insertion of N blanks at the 
left on the 1403 output, thus allowing the user to center 
his output on the paper . tf N=0, the WYLBUR listing 
routine does not put. any carriage control characters in 
print position one and it is assumed that the data set 
contains the carriage control characters (be careful that 
the UNNUMBERED option is specified when N=0 so that line 
numbers are not picked up as carriage control characters). 
(See page E-38.) 

If the TITLE is specified in an OFFLINE list, It will 


be printed as the heading for the first page of the output. 


The TITLE may not have more than 60 characters. (See page 


E-38,) 


The <RUN PRIORITY> and <PRINT PRIORITY> specify the 


priority that the user wishes to have attached to these two 

stages of the processing of his job. (See page E-39 ff.) 
The MC option is only valid when) an UNNUMBERED OFFLINE 

(0) list is being done with a data set created by one of the 


1BM assemblers. (See page £-39.) 


OCAT OMMAND 

This command allows the user to inquire about the 
status of any job which he has put into the job queue 
through WYLBUR. This may be a job created by use of the 
RUN command or the LIST OFFLINE command. 

LOCATE XXX 
LOCATE JOBNAME 

XXX is the job number which has been assigned to the 
user's job. (See page E-57.) 

In the second form of the command, the batch stream is 
searched for all jobs having the specified JOBNAME. The 
job number of each job found will be printed out and the 
Status of the last one found will be determined and printed 


for the user. (See page £-57,) 


O0GO OMM 
This command allows the user to terminate the session. 


The <WORKING DATA SETD is not automatically saved -- LOGOFF 
includes an implicit CLEAR. 
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LOGOFF 


(See page E-65.) 


M MAND | 

The MODIFY command allows the user to alter the 

contents of each line ina specified <RANGE>. Successive 

lines are prompted for alteration until the <RANGE> is. 
exhausted. 

MODIFY <RANGE> 

(See page E-48 ff.) 


For each line in the specified <RANGE> the following 


process is followed. First the image of the line as Tt now az 


stands is printed out for the user. Then the user is 
prompted to specify an alteration to be made.to the line. 
Alterations are one of the following 


Insert ~ | 

The letter | is typed immediately below the 
character in the line before which characters are 
to be inserted. This indicator is followed by the 
string of characters which are to be inserted. The 
string of characters to be inserted is terminated 
by a carriage return. (See page E-49.) 
Replace = R 

This indicator is typed immediately betow the 
first character to be replaced in the line, The 
string of replacement characters is typed 
immediately following the indicator. As many 
characters are replaced as there are characters 
in the string of replacement characters. 
(See page E-49, ) 
Delete - D ° 

A string of characters to be deleted from the 
line is delineated by typing a D under each 
successive character to be removed. The user need 
only type a D underneath the first and last 
character in the string to be deleted =- al] 
characters between the two D's are also deleted. 
(See page E-48, ) 

The deletion range may be terminated by typing 


either an | or R indicator. If terminated by an R 
indicator, the characters following the deleted 
string are replaced by the replacement string that 
the user specifies. If the deletion range is 
terminated by an | indicator, the effect is 
replacement of the deleted characters with the 
string to be inserted. (See page E-50.) 


After the alteration is specified, the user should. type 


a return. WYLBUR will make the indicated alterations in: 


the line and type the new image of the line out for the 


user to inspect. Then WYLBUR will- prompt for more 
alterations. The user signals that all aikeracions have 
been made by typing only a carriage return in answer to the 
alteration prompt. This will cause WYLBUR to put the new 
image of \ the line into the data set and prompt for 
alterations to the next line in the <RANGE>. (See page 
E=50.) 

The printing of the altered image of the line may be 
suspended by typing an N indictor into the alteration line 
before any other alteration Indicators. (See page E-51.) 

The user may have WYLBUR type out the image, = it 
currently stands, of the line being modified by typing a 
few blanks into the alteration line and issuing a carriage 
return. (See page £-51.) 

The user may renege on all alterations made to a line 
by typing an ATTN as the first character in the alters 


line. WYLBUR will forget about all alterations which the 


user may have made to the line Presently being altered and 


the image of the line will remain what it = was. before 


alterations were made. (See page E-52.) 
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MOVE COMMAND 

This command moves a_e specified <RANGE>. It is 
essentially a COPY command followed by a DELETE. comand, 
where the old instances of the copied lines are deleted. 

MOVE <RANGE> TO (XXXX.XXX[END) [BY YYYY.YYY_] 

(See page E-47 ff.) 

If YYYY.YYY is not specified, the current value of the 
global parameter DELTA is used in its place. (See page 
E-31.) 

The special line number END is defined as DELTA higher 
than the current LAST. (See page E-47.) 

The user may not ‘MOVE lines from an <EXTERNAL DATA SET> 
into the <WORKING DATA SET>. (See page E-47.) 


NUMBER COMMAND 

This permits the user to have his entire data set 
renumbered. 

NUMBER [xXxxx.xxxJ [BY yyyy.yyyY] 
(See page F-41.) 

XXX.XXX is the new number for the first line in the 
data set. If it is not specified, 1.000 is used. (See 
page E-41,) 

YYYY.YYY is the DELTA to be used in deriving successive 
line numbers. If ft is not specified, the current value of 


the global parameter DELTA is used. (See Page E-31, ) 
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PRINT PRIORITY 
The priority to be attached to the print phase of a 
job. Must be one of the following, which are in decreasing 
order 
URGENT 
PRIORITY 
STANDARD 
IDLE 
OVERNITE ; 
NOPRINT - don't do the print phase 


STANDARD is the default priority. (See page E-39 ff.) 


PUNCH COMMAND 


This command allows the user to produce a punched card 
deck of a <RANGE> in the <WORKING DATA SET>, 

PUNCH <RANGE> [UNNUMBERED] [ACCOUNT xxxx] [BIN yYY] 
[kRUN PRIORITY>] [<PRINT PRIORI TY> ] 
(See page E-39.) . 

The ACCOUNT and BIN options are the same as in the LIST 
OFFLINE command. (See page E-38.) 

1 the UNNUMBERED option ftsn't specified, the line 
numbers will be punched into columns 73-80 of the ard: 
(See page E-38.) 

~The PUNCH command automatically produces an offline 
listing of all the cards that are punched unless a <PRINT 
PRIORITY> of NOPRINT is specified. (See page E-38.) 

The <RUN- PRIORITY> and <PRINT PRIORITY> specify the 

priority that the user wishes to have attached to these two 


Stages of the processing of his Job. (See page E-39 ff.) 
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RANGE 
This is either an <EXPLICIT RANGE> or an <ASSOCIATIVE 
RANGED. 
REPLACE COMMAND. 


This allows the user to replace the content string of 

any specified <RANGE> in the <WORKING DATA SET>. | 
REPLACE <RANGE> 
(See page E-42 ff.) 

WYLBUR will prompt with successive line numbers in the 
specified <RANGE>, expecting the user to type in the new 
contents after each prompt. This fis continued until the 
<RANGE> Is exhausted. (See page E-43.) 

Alternatively, the user may replace the contents of a 
single line by giving the <LINE NUMBER>, followed by a 
single blank, and then the new contents of the line. (See 


alternative form of the INSERT command.) (See page E-43.) 


RUN COMMAND 

This command allows the user to put the <WORKING DATA 
SET> Into the HASP job input stream of the 360/67 

RUN [UNNUMBERED_] [<RUN PRIORITY>| [KPRINT PRIORITY>] 
(See page E-56 ff.) 
The data set will be converted to CARD format (remember 

that the <WORKING DATA SET> Is always in edit format while 
being worked upon). (See page E-56.) | 


If the UNNUMBERED option is not given, the line numbers 


of the lines of text will be put into columns 73-80, (See 
page E-56.) | 

The <RUN PRIORITY> and <PRINT PRIORITY> specify the 
priority that the user wishes to have attached to these two 


Stages of the processing of his job. (See page E-57.) 


RUN PRIORITY 


The priority to be attached to the execution phase of a 
job. Must be one of the following, which are in decreasing 
order 

URGENT 

PRIORITY 

EXPRESS 

STANDARD 

IDLE 

OVERNITE 
STANDARD is the default priority for jobs entered via the 
card readers and EXPRESS is the default priority for jobs 
entered via WYLBUR, See the fuller explanation of 
Priorities in the main text of the user's manual. (See 


page E~39 ff.) 


SAVE COMMAND 
The SAVE command tells WYLBUR to save the current 
<WORKING DATA SET>, having a name which the user specifies, 
on some external storage device, 
SAVE <DSNAME> [ON <VOLUME>] [FORMATS] [(Ny] 
CscratcH] [NuMBERED) [PRIVATE] 
(See page E-61 ff.) 


The data set will be saved with the expanded name 
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XXXX, <DSNAME>, where XXXX is the user's account number. 

If the <FORMAT> is not specified, WYLBUR will ask the 
user what <FORMAT> he desires. (See page E-62.) 

The (N) phrase specifies a blocking factor - the number 
of lines which should be placed into each record. (See 
page E-64.) | 

if anold copy of the data set already exists on the 
storage device, WYLBUR will ask the user whether he wishes 
the old copy scracched before storing the new copy, unless 
the SCRATCH option is specified. (See page E-62.) 

If no <VOLUME> its given, WYLBUR will store the data set 
on the first aval lable storage device which it finds. (See 
page E-63,) 

The NUMBERED option is only valid when <FORMAT> fs CARD 
or LRECL = 80 and causes the line numbers to be retained as 


the contents of character positions 73-80, (See page 


E-63,) 


if the data set is saved with a PRIVATE option, then 
only auser signed on with the appropriate account number 
will be able to access the data set. The full DSNAME will 


be XXXX.*,DSNAME, where XXXX is the user's account number. 


(See page —£-22,) 


SCR MMAND 


This command allows” the user to scratch any <EXTERNAL 


DATA SET> which belongs to him. 


SCRATCH <DSNAME> LON <VOLUME>] 


(See page E-61.) 


SE MMA 
SET DELTA = XXXX. XXX 
This sets the value of the global DELTA, and hence the 
default value to be used In all commands where a DELTA may 


be specified. (See page E-31.) 


XXXX.XXX may be any value between .001 and 9999.999 0 


(inclusive). . 

DELTA has a value of 1.000 unless’ the user specifies 
otherwise. . 

SET TABS [=NA[,NB ... ,NN] |] | 

This allows the user to Inform WYLBUR of what tab 
setting are in effect at the terminals. WYLBUR will prompt 
with directions telling the user what to do. If no tabs 
have been set (or If not enough tabs have been set ~ e.g. 
only three set and the tab key pressed four or more times) 
any use of the tab key will cause WYLBUR to forget about 
processing the line and Issue an error message. (See page 
E-29 ff.) 

SET LENGTH = N 


the LENGTH is the number of characters which may be in 


any line of text. if the user types ina line of text - 


containing more than this number of characters, WYLBUR will 


accept the line. but issue a warning message to tell the 


user that he has exceeded the limit which was specified. 


(See page E~29,) 


N may be an integer between 1 and 133 (inclusive). 
LENGTH has a value of 72 unless’ the user specifies 
otherwise. 7 
SET UPLOW 
SET UPPER | 
These commands govern the case. of alphabetic 
characters. Normally, all alphabetic characters are 
recognized as upper case. if UPLOW is specified, full _ 
upper and lower case facilities are available to the user. - 
If UPLOW is in effect, the user may revert “to the normal 
case (all alphabetic characters in upper case) by giving 
the SET UPPER command. (See page E-32 ff.) ne 
SET OVERFLOW = (ON|OFF) | co 
This command turns on and off the OVERFLOW option for. 


COLLECT mode. (See page E-32.) 


OMM 
SHOW DELTA 
SHOW LENGTH 
SHOW TABS 
SHOW CASE 
SHOW OVERFLOW 
These commands allow the user to find out the current 


value or any of the global parameters. (See page E-33 ff.) 


SHOW LAST 
LAST. is the number of the last line In the <WORKING 
DATA SET>. (See page E~33.)_ OS | 


SHOW DSNAMES ON <VOLUME> 


This will result in a listing of the <DSNAME>s of all 
EXTERNAL DATA SET>s which belong to the user. If the 
<VOLUME> is specified, the DSNAMES of data sets belonging 
to the user and residing only on the specified volume will 
be retrieved, (See page E-61.) 

SHOW OPERATOR 'STRING' 

The STRING is sent as a message to the 360 operator. 
This may be used to communicate set up information. (See 
page E-57.) 

SHOW TIME 


The current time, in hours, minutes, and seconds, is 


‘printed for the user. (See page E-61.) 
SHOW STATUS 
. The current load of work on the 360, in terms of the 
jobs being executed and the Jobs awaiting processing, is 
printed out for the user. (See page E-58,) 
SHOW ‘RUN 
SHOW PRINT 
These commands produce a listing of the queues, broken 
down into the various priority Glasses, awaiting execution 


and printing, respectively. (See page E-58.) 


LGN-ON P UR: 

This Is the dialogue carried on between’ the user and 
the Stanford Terminal Processor and {fs used to determine 
the validity of the user's account number and the right of 


the user to employ WYLBUR. (See page E-17 ff.) 
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U OMMAND 

The USE command tells WYLBUR that the user wants to 
work on an <EXTERNAL DATA SET> and that WYLBUR is to get a 
copy of it so that modifications may be made. 

USE NAME [ON <vOLUME>] [KFORMAT>] [SKIP XxxX_] [NUMBERED] 

where NAME is just <DSNAME> for a data set belonging 
to the user 
is &XXXX.<DSNAME> for a data set belonging 
to a user with Account number XXXX 
(See page E-26 ff.) 

If the user does not specify the <FORMAT>, WYLBUR will 
ask that it bé specified in answer to a prompt. (See page 
E-28,) 

The SKIP option allows the user to skip over XXXX 
records at the beginning of the data set being used. The 
first line of the <WORKING DATA SET>. will become the 
(XXXX+1)th line of the <EXTERNAL DATA SET). (See page 
E-29.) 

The NUMBERED option is only valid when <FORMAT> is CARD 
or LRECL = 80 and causes the line numbers to be taken as 


the contents of character positions 73-80 and these 


character positions are blanked out. (See page E-63.) 


VOLUME 
These are names of the storage devices used to hold 
WYLBUR data sets - e.g. SYS07 or SYSOk. See current 
issues of the User's Bulletin for the names of volumes 


which are available to the WYLBUR user. (See page E-14.) 


WORKING DATA SET 


The data set which constitutes the user's scope of 
attention and upon which the user is affecting changes. 


(See page E-16.) 
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